nodeFromID Method (Windows CE 5.0)

Send Feedback

Returns the node that matches the ID attribute.

[Script]

Script Syntax

varobjXMLDOMNode=oXMLDOMDocument.nodeFromID(idString);

Script Parameters

  • idString
    String containing the value of the ID to match.

Script Return Value

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

[C/C++]

C/C++ Syntax

HRESULT nodeFromID(BSTRidString,IXMLDOMNode** node);

C/C++ Parameters

  • idString
    [in] Value of the ID to match.
  • node
    [out, retval] Node that matches the supplied ID. If no nodes match, this method returns Null.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • S_FALSE
    Value returned when there is no node with the given ID.
  • E_INVALIDARG
    Value returned if node is Null.

Requirements

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

General Remarks

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/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 by 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 World Wide Web Consortium (W3C) Document Object Model (DOM).

This method applies to the following interface:

DOMDocument

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.