ExpressionStore.NewExpression Method (PIA)

Article
11/12/2009

Use this method to return an ADO _Recordset interface to a hierarchical Recordset object that contains an empty expression.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Targeting
Imports ADODB26Lib     ‘ for _Recordset
…
Public Function NewExpression() As _Recordset

[C#]

using Microsoft.CommerceServer.Interop.Targeting;
using ADODB26Lib;                              //For _Recordset
…
public _Recordset NewExpression();

Return Values

[Visual Basic .NET] If this method completes successfully, it returns the _Recordset interface of a Recordset object that contains an empty expression.

[C#] This method returns an ADO _Recordset interface to a hierarchical Recordset object that contains an empty expression.

Exceptions

This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.

[Visual Basic .NET]

The following table shows the custom COM errors that a COMException can wrap.

Value	Description
&H8110001F	Invalid connection
&H8110000D	No connection string specified

[C#]

The following table shows the custom COM errors that COMException can wrap.

Value	Description
0x8110001F	Invalid connection
0x8110000D	No connection string specified

Remarks

Populate the returned Recordset object with data describing the new expression. For information on the format and required fields of the Recordset object, see Expression Recordset.

Save the newly defined expression to the expression store using the SaveExpression method. The SaveExpression method automatically generates a new, unique expression ID and stores it with the new expression.

Call the Connect method before calling the NewExpression method.

Requirements

Namespace: Microsoft.CommerceServer.Interop.Targeting

Platforms: Windows 2000, Windows Server 2003

Assembly: exprarchlib (in exprarchlib)