XmlDocument.GetElementById(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает элемент XmlElement с указанным идентификатором.
public:
virtual System::Xml::XmlElement ^ GetElementById(System::String ^ elementId);
public virtual System.Xml.XmlElement? GetElementById (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
Идентификатор атрибута для сопоставления.
Возвращаемое значение
Элемент XmlElement
с соответствующим кодом или значение null
, если соответствующий элемент не найден.
Примеры
В следующем примере используется метод GetElementById
.
#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
используется в качестве входных данных.
<!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>
Комментарии
Если документ содержит несколько элементов с соответствующим идентификатором, этот метод возвращает первый соответствующий элемент в документе.
Примечание
Реализация DOM должна содержать сведения, определяющие, какие атрибуты имеют идентификатор типа. Хотя атрибуты идентификатора типа можно определить в схемах XSD или DTD, эта версия продукта поддерживает только те, которые определены в DTD. Атрибуты с именем "ID" не имеют идентификатора типа, если только это не определено в DTD. Реализации, в которых неизвестно, возвращаются null
ли атрибуты с идентификатором типа.