XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) XmlDocument.GetElementById(String) Method

정의

지정된 ID의 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 String String String

일치시킬 특성 ID입니다.The attribute ID to match.

반환

일치하는 ID가 있으면 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
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 'Main 
End Class 'Sample

이 예제에서는 파일을 사용 하 여 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>  

설명

문서에 일치 하는 ID 사용 하 여 여러 요소를이 메서드는 문서의 첫 번째 일치 하는 요소를 반환 합니다.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. XSD 스키마 또는 Dtd를 특성 유형 ID 정의할 수 있지만이 버전의 제품 지원 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. DTD에서 정의 하지 않으면 "ID" 아닌 이름 가진 특성 ID를 입력 합니다.Attributes with the name "ID" are not of type ID unless so defined in the DTD. Id 형식 특성이 인지 알 수 없는 구현을 반환 해야 하는 null합니다.Implementations where it is unknown whether the attributes are of type ID are expected to return null.

적용 대상