XmlDocument.GetElementById(String) Methode

Definitie

Hiermee haalt u de XmlElement opgegeven id op.

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

Parameters

elementId
String

De kenmerk-id die moet overeenkomen.

Retouren

De XmlElement met de overeenkomende id of null als er geen overeenkomend element wordt gevonden.

Voorbeelden

In het volgende voorbeeld wordt de methode GetElementById gebruikt.


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

In het voorbeeld wordt het bestand als ids.xmlinvoer gebruikt.

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

Opmerkingen

Als het document meerdere elementen heeft met de overeenkomende id, retourneert deze methode het eerste overeenkomende element in het document.

Note

De DOM-implementatie moet informatie bevatten die bepaalt welke kenmerken van het type ID zijn. Hoewel kenmerken van het type ID kunnen worden gedefinieerd in XSD-schema's of DTD's, ondersteunt deze versie van het product alleen de kenmerken die zijn gedefinieerd in DTD's. Kenmerken met de naam 'ID' zijn niet van het type ID, tenzij dit is gedefinieerd in de DTD. Implementaties waarbij het onbekend is of de kenmerken van het type ID worden verwacht te retourneren null.

Van toepassing op