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。一致する要素が見つからない場合は nullThe 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. 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. そのため、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.

適用対象