setProperty Method (Windows CE 5.0)

Article
09/14/2012

Used for setting the SelectionLanguage or SelectionNamespaces internal properties (flags).

[Script]

Script Syntax

objXMLDOMDocument2.setProperty(name,value);

Script Parameters

name
The SelectionLanguage value.
value
Either the "XPath" or "XSLPattern" value.

Script Return Value

None.

[C/C++]

C/C++ Syntax

HRESULT setProperty(BSTRname,VARIANTvalue);

C/C++ Parameters

name
[in] The "SelectionLanguage" value.
value
[in] Either "XPath" or "XSLPattern".

C/C++ Return Values

S_OK
Value returned if successful.
E_FAIL
Value returned if name or value is invalid.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Link Library: Uuid.lib.

General Remarks

The following table shows properties that you can set using this method. Existing properties from DOMDocument are not accessible through this method. White space is not stripped or normalized in property names or values.

Name Value

Name	Value
SelectionLanguage internal property (flag)	"XPath" or "XSLPattern" The SelectionLanguage property defaults to "XSLPattern". This property indicates the type of query the user plans to pass into selectNodes or selectSingleNode. "XSLPattern" is the default for backward compatibility. This flag applies to all nodes whose ownerDocument property points to this document object. Therefore, if a given node is moved to a different document, its selectNode behavior may change depending on the SelectionLanguage setting in the new document. The following Jscript example on the client shows how to set the SelectionLanguage to XPath for the xmldoc object. `var xmldoc = new ActiveXObject("Msxml2.DOMDocument"); var selection; xmldoc.loadXML ("<Customer><Name>Microsoft</Name></Customer>"); xmldoc.setProperty("SelectionLanguage", "XPath"); selection = xmldoc.selectNodes("Customer/Name"); alert(selection.expr + " -- " + selection.item(0).xml);`
SelectionNamespaces internal property (flag)	A space delimited set of Namespace names. For example: `oDomDocument.setProperty("SelectionNamespaces", "xmlns:example1='http://myserver.com' xmlns:example2='http://yourserver.com'");` With the SelectionNamespaces internal property (flag), the selectSingleNode method and selectNodes method can now use qualified names.

SelectionLanguage internal property (flag)

"XPath" or "XSLPattern"

The SelectionLanguage property defaults to "XSLPattern". This property indicates the type of query the user plans to pass into selectNodes or selectSingleNode. "XSLPattern" is the default for backward compatibility. This flag applies to all nodes whose ownerDocument property points to this document object. Therefore, if a given node is moved to a different document, its selectNode behavior may change depending on the SelectionLanguage setting in the new document. The following Jscript example on the client shows how to set the SelectionLanguage to XPath for the xmldoc object.

var xmldoc = new ActiveXObject("Msxml2.DOMDocument");
var selection; 
xmldoc.loadXML ("<Customer><Name>Microsoft</Name></Customer>");
xmldoc.setProperty("SelectionLanguage", "XPath");
selection = xmldoc.selectNodes("Customer/Name");
alert(selection.expr + " -- " + selection.item(0).xml);

SelectionNamespaces internal property (flag)

A space delimited set of Namespace names.

For example:

oDomDocument.setProperty("SelectionNamespaces", 
"xmlns:example1='http://myserver.com' 
xmlns:example2='http://yourserver.com'");

With the SelectionNamespaces internal property (flag), the selectSingleNode method and selectNodes method can now use qualified names.

This method applies to the following interface:

IXMLDOMDocument2.