XmlDocument.GetElementById-Methode

Ruft das XmlElement mit der angegebenen ID ab.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Function GetElementById ( _
    elementId As String _
) As XmlElement
'Usage
Dim instance As XmlDocument
Dim elementId As String
Dim returnValue As XmlElement

returnValue = instance.GetElementById(elementId)

public virtual XmlElement GetElementById (
    string elementId
)

public:
virtual XmlElement^ GetElementById (
    String^ elementId
)

public XmlElement GetElementById (
    String elementId
)

public function GetElementById (
    elementId : String
) : XmlElement

Parameter

• elementId
  Die Attribut-ID, mit der eine Übereinstimmung gefunden werden soll.

Rückgabewert

Das XmlElement mit der passenden ID oder NULL (Nothing in Visual Basic), wenn kein übereinstimmendes Element gefunden wurde.

Hinweise

Wenn das Dokument über mehrere Elemente mit der passenden ID verfügt, gibt diese Methode das erste übereinstimmende Element im Dokument zurück.

Hinweis

Die DOM-Implementierung muss über Informationen verfügen, die definieren, welche Attribute vom Typ ID sind. Obwohl Attribute vom Typ ID entweder in XSD-Schemas oder in DTDs definiert werden können, unterstützt diese Produktversion ausschließlich die in DTDs definierten Attribute vom Typ ID. Attribute mit dem Namen "ID" sind nicht vom Typ ID, wenn sie nicht in der DTD als solcher definiert wurden. Wenn bei Implementierungen nicht bekannt ist, ob die Attribute vom Typ ID sind, wird davon ausgegangen, dass sie NULL (Nothing in Visual Basic) zurückgeben.

Beispiel

Im folgenden Beispiel wird die GetElementById-Methode verwendet.

Option Explicit
Option Strict

Imports System
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 'Main 
End Class 'Sample

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

  }
}

#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 );
}

import System.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        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.get_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.get_OuterXml());
    } //main
} //Sample

Im Beispiel wird die Datei ids.xml als Eingabe verwendet.

<!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='A111'/>
  <Person SSN='A222' Name='Tom'/>
  <Customer id='A111'/>
  <Customer id='A222334444'/>
  <Team members='A222334444 A333445555'/>
</root>

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XmlDocument-Klasse
XmlDocument-Member
System.Xml-Namespace