XmlDocument.GetElementById(String) Método

Definición

Obtiene el XmlElement objeto con el identificador especificado.

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

Parámetros

elementId
String

Identificador de atributo que se va a coincidir.

Devoluciones

XmlElement con el identificador coincidente o null si no se encuentra ningún elemento coincidente.

Ejemplos

En el ejemplo siguiente se usa el GetElementById método .


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

En el ejemplo se usa el archivo , ids.xmlcomo entrada.

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

Comentarios

Si el documento tiene varios elementos con el identificador coincidente, este método devuelve el primer elemento coincidente del documento.

Note

La implementación dom debe tener información que defina qué atributos son de tipo ID. Aunque los atributos de identificador de tipo se pueden definir en esquemas XSD o DTD, esta versión del producto solo admite las definidas en DTD. Los atributos con el nombre "ID" no son de tipo ID a menos que se definan en el DTD. Las implementaciones en las que se desconoce si se espera que los atributos sean de tipo ID devuelvan null.

Se aplica a