setProperty Method

  • Article

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

objXMLDOMDocument2.setProperty(name, value);

HRESULT setProperty(
  BSTR name,
  VARIANT value
);

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
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.

See Also

selectNodes Method | selectSingleNode Method

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.