expr Property

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Gets or sets the XML Path Language (XPath) expression string.

Script Syntax

            strExpression = objXMLDOMSelection.expr;
objXMLDOMSelection.expr = strExpression;

Remarks

Script Parameters

None.

Script Return Value

String. The IXMLDOMSelection expression string is either XSL Pattern or XPath syntax, depending on the setting of the SelectionLanguage internal property (flag) on the IXMLDOMDocument2 interface that created this Selection object. (For more information, see IXMLDOMDocument2::setProperty.) After it is created, the IXMLDOMSelection object continues to use the expression language with which it was created.

C/C++ Syntax

HRESULT get_expr(
  BSTR* expression
);
HRESULT put_expr(
  BSTR expression
);

Remarks

C/C++ Parameters

• expression
  [out, retval][in] The IXMLDOMSelection expression string is either XSL Pattern or XPath syntax, depending on the setting of the SelectionLanguage internal property (flag) on the IXMLDOMDocument2 interface that created this Selection object. (For more information, see IXMLDOMDocument2::setProperty.) After it is created, the IXMLDOMSelection object continues to use the expression language with which it was created.

C/C++ Return Values

• S_OK
  Value returned if method is successful.

E_FAIL and formatted error message through IErrorInfo if expression is invalid.

Requirements

General Remarks

Setting a new expression immediately resets the state of this node list to the beginning unless the expression is invalid and an error is returned, in which case it has no effect. It does not reset the context.

This property applies to the following interface:

IXMLDOMSelection.