Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

nodeFromID Method

 

Returns the node that matches the ID attribute.

var objXMLDOMNode = oXMLDOMDocument.nodeFromID(idString);  

Parameters

idString
The string containing the value of the ID to match.

Return Value

An object. Returns the node that matches the supplied ID. If no nodes match, returns Null.

HRESULT nodeFromID(  
    BSTR idString,  
    IXMLDOMNode **node);  

Parameters

idString[in]
The value of the ID to match.

node[out, retval]
The node that matches the supplied ID. If no nodes match, this method returns Null.

Return Values

S_OK
The value returned if successful.

S_FALSE
The value returned when there is no node with the given ID.

E_INVALIDARG
The value returned if the node parameter is Null.

According to the XML 1.0 Recommendation (REC-xml-19980210), ID attribute values must be unique within their XML documents and no element can specify more than one ID attribute.

The nodeFromID method was designed to handle ID and IDREF relationships in XML, but does not require an attribute of type IDREF. It can be used generically, and is similar to the all collection in DHTML.

To reference a node with nodefromID, the node must be typed as ID in the schema or document type definition (DTD). Simply naming an attribute "ID" does not set its data type.

This member is an extension of the Worldwide Web Consortium (W3C) Document Object Model (DOM).

Implemented in: MSXML 3.0 and MSXML 6.0

IXMLDOMDocument-DOMDocument

Show:
© 2017 Microsoft