setProperty Method (Compact 2013)

  • Article

3/26/2014

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

Syntax

objXMLDOMDocument2.setProperty(name, value);

HRESULT setProperty(
  BSTR name,
  VARIANT value
);

Parameters

Script

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

C/C++

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

Return Value

Script

None.

C/C++

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

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

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>");
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.

Requirements

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

XML DOM Methods
selectNodes Method
selectSingleNode Method