XmlDocument.GetElementById(String) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlDocument.cs

Lekéri a XmlElement megadott azonosítót.

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

Paraméterek

elementId

String

A megfeleltetendő attribútumazonosító.

Válaszok

XmlElement

A XmlElement megfelelő azonosítóval rendelkező, vagy null ha nem található egyező elem.

Példák

Az alábbi példa a metódust GetElementById használja.

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

A példa a fájlt ids.xmlhasználja bemenetként.

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

Megjegyzések

Ha a dokumentum több elemet tartalmaz az egyező azonosítóval, ez a metódus a dokumentum első egyező elemét adja vissza.

Note

A DOM-implementációnak olyan információkkal kell rendelkeznie, amelyek meghatározzák, hogy mely attribútumok típusazonosítók. Bár a típusazonosító attribútumai XSD-sémákban vagy DTD-kben is meghatározhatók, a termék ezen verziója csak a DTD-kben definiáltakat támogatja. Az "ID" nevű attribútumok csak akkor tartoznak típusazonosítóhoz, ha a DTD-ben ezt meg nem határozták. Azok a implementációk, amelyekben ismeretlen, hogy az attribútumok típusazonosítójúak-e, a rendszer várhatóan visszaadja null.