XmlDocument.GetElementById(String) Метод

Определение

Возвращает элемент XmlElement с указанным идентификатором.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

Параметры

elementId
String

Идентификатор атрибута для сопоставления.The attribute ID to match.

Возвраты

Элемент XmlElement с соответствующим кодом или значение null, если соответствующий элемент не найден.The XmlElement with the matching ID or null if no matching element is found.

Примеры

В следующем примере используется метод GetElementById.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

В этом примере в качестве входных данных используется файл ids.xml.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>  

Комментарии

Если документ содержит несколько элементов с совпадающим ИДЕНТИФИКАТОРом, этот метод возвращает первый соответствующий элемент в документе.If the document has multiple elements with the matching ID, this method returns the first matching element in the document.

Примечание

Реализация DOM должна содержать сведения, определяющие, какие атрибуты имеют тип ID.The DOM implementation must have information which defines which attributes are of type ID. Хотя атрибуты типа ID могут быть определены либо в XSD-схемах, либо в DTD, эта версия продукта поддерживает только те, которые определены в DTD.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. Атрибуты с именем ID не имеют тип ID, если не определено в DTD.Attributes with the name "ID" are not of type ID unless so defined in the DTD. Реализации, где неизвестно, должны ли быть возвращены nullатрибуты с идентификатором типа.Implementations where it is unknown whether the attributes are of type ID are expected to return null.

Применяется к