XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) Method

Definition

Ruft das XmlElement mit der angegebenen ID ab.Gets the XmlElement with the specified ID.

public:
 virtual System::Xml::XmlElement ^ GetElementById(System::String ^ elementId);
public virtual System.Xml.XmlElement GetElementById (string elementId);
abstract member GetElementById : string -> System.Xml.XmlElement
override this.GetElementById : string -> System.Xml.XmlElement
Public Overridable Function GetElementById (elementId As String) As XmlElement

Parameter

elementId
String String String String

Die Attribut-ID, mit der eine Übereinstimmung gefunden werden soll.The attribute ID to match.

Gibt zurück

Das XmlElement mit der passenden ID oder null, wenn kein übereinstimmendes Element gefunden wurde.The XmlElement with the matching ID or null if no matching element is found.

Beispiele

Im folgenden Beispiel wird die GetElementById-Methode verwendet:The following example uses the GetElementById method.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->Load( "ids.xml" );
   
   //Get the first element with an attribute of type ID and value of A111.
   //This displays the node <Person SSN="A111" Name="Fred"/>.
   XmlElement^ elem = doc->GetElementById( "A111" );
   Console::WriteLine( elem->OuterXml );
   
   //Get the first element with an attribute of type ID and value of A222.
   //This displays the node <Person SSN="A222" Name="Tom"/>.
   elem = doc->GetElementById( "A222" );
   Console::WriteLine( elem->OuterXml );
}


using System;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.Load("ids.xml");

    //Get the first element with an attribute of type ID and value of A111.
    //This displays the node <Person SSN="A111" Name="Fred"/>.
    XmlElement elem = doc.GetElementById("A111");
    Console.WriteLine( elem.OuterXml );

    //Get the first element with an attribute of type ID and value of A222.
    //This displays the node <Person SSN="A222" Name="Tom"/>.
    elem = doc.GetElementById("A222");
    Console.WriteLine( elem.OuterXml ); 

  }
}
Option Explicit
Option Strict

Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.Load("ids.xml")
        
        'Get the first element with an attribute of type ID and value of A111.
        'This displays the node <Person SSN="A111" Name="Fred"/>.
        Dim elem As XmlElement = doc.GetElementById("A111")
        Console.WriteLine(elem.OuterXml)
        
        'Get the first element with an attribute of type ID and value of A222.
        'This displays the node <Person SSN="A222" Name="Tom"/>.
        elem = doc.GetElementById("A222")
        Console.WriteLine(elem.OuterXml)
    End Sub
End Class

Im Beispiel wird die-Datei ids.xmlals Eingabe verwendet.The example uses the file, ids.xml, as input.

<!DOCTYPE root [  
  <!ELEMENT root ANY>   
  <!ELEMENT Person ANY>   
  <!ELEMENT Customer EMPTY>  
  <!ELEMENT Team EMPTY>  
  <!ATTLIST Person SSN ID #REQUIRED>  
  <!ATTLIST Customer id IDREF #REQUIRED >  
  <!ATTLIST Team members IDREFS #REQUIRED>]>  
<root>  
  <Person SSN='A111' Name='Fred'/>  
  <Person SSN='A222' Name='Tom'/>  
  <Customer id='A222334444'/>  
  <Team members='A222334444 A333445555'/>  
</root>  

Hinweise

Wenn das Dokument über mehrere Elemente mit der entsprechenden ID verfügt, gibt diese Methode das erste übereinstimmende Element im Dokument zurück.If the document has multiple elements with the matching ID, this method returns the first matching element in the document.

Hinweis

Die DOM-Implementierung muss über Informationen verfügen, die definieren, welche Attribute vom Typ "ID" sind.The DOM implementation must have information which defines which attributes are of type ID. Obwohl Attribute des Typs ID in XSD-Schemas oder DTDs definiert werden können, unterstützt diese Version des Produkts nur die in DTDs definierten.Although attributes of type ID can be defined in either XSD schemas or DTDs, this version of the product only supports those defined in DTDs. Attribute mit dem Namen "ID" sind nicht vom Typ "ID", es sei denn, Sie sind in der DTD definiert.Attributes with the name "ID" are not of type ID unless so defined in the DTD. Implementierungen, bei denen es nicht bekannt ist, ob die Attribute vom Typ "ID null" zurückgegeben werden sollen.Implementations where it is unknown whether the attributes are of type ID are expected to return null.

Gilt für: