XmlDocument.GetElementsByTagName メソッド

定義

指定した名前に一致するすべての子孫の要素のリストを格納している XmlNodeList を返します。Returns an XmlNodeList containing a list of all descendant elements that match the specified name.

オーバーロード

GetElementsByTagName(String)

指定した XmlNodeList に一致するすべての子孫の要素のリストを格納している Name を返します。Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String, String)

指定した XmlNodeList および LocalName に一致するすべての子孫の要素のリストを格納している NamespaceURI を返します。Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

GetElementsByTagName(String)

指定した XmlNodeList に一致するすべての子孫の要素のリストを格納している Name を返します。Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ name);
public virtual System.Xml.XmlNodeList GetElementsByTagName (string name);
abstract member GetElementsByTagName : string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string -> System.Xml.XmlNodeList
Public Overridable Function GetElementsByTagName (name As String) As XmlNodeList

パラメーター

name
String

一致する限定名。The qualified name to match. 一致するノードの Name プロパティに一致します。It is matched against the Name property of the matching node. 特殊値の "*" は、すべてのタグに一致します。The special value "*" matches all tags.

戻り値

一致しているすべてのノードのリストを格納している XmlNodeListAn XmlNodeList containing a list of all matching nodes. name と一致するノードがない場合、返されるコレクションは空になります。If no nodes match name, the returned collection will be empty.

次の例では、XmlDocument オブジェクトを作成し、GetElementsByTagName メソッドと、結果として得られる XmlNodeList オブジェクトを使用して、すべての書籍のタイトルを表示します。The following example creates a XmlDocument object and uses the GetElementsByTagName method and the resulting XmlNodeList object to display all the book titles.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->Load( "books.xml" );
   
   //Display all the book titles.
   XmlNodeList^ elemList = doc->GetElementsByTagName( "title" );
   for ( int i = 0; i < elemList->Count; i++ )
   {
      Console::WriteLine( elemList[ i ]->InnerXml );
   }
}
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.Load("books.xml");

    //Display all the book titles.
    XmlNodeList elemList = doc.GetElementsByTagName("title");
    for (int i=0; i < elemList.Count; i++)
    {
      Console.WriteLine(elemList[i].InnerXml);
    }
  }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.Load("books.xml")
        
        'Display all the book titles.
        Dim elemList As XmlNodeList = doc.GetElementsByTagName("title")
        Dim i As Integer
        For i = 0 To elemList.Count - 1
            Console.WriteLine(elemList(i).InnerXml)
        Next i
    End Sub
End Class

この例は、books.xml ファイルを入力として使用します。The example uses the books.xml file as input.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

注釈

ノードは、ドキュメント内に出現する順序で配置されます。The nodes are placed in the order in which they would be encountered in the document.

注意

GetElementsByTagName メソッドの代わりに、XmlNode.SelectNodes または XmlNode.SelectSingleNode メソッドを使用することをお勧めします。It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

GetElementsByTagName(String, String)

指定した XmlNodeList および LocalName に一致するすべての子孫の要素のリストを格納している NamespaceURI を返します。Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ localName, System::String ^ namespaceURI);
public virtual System.Xml.XmlNodeList GetElementsByTagName (string localName, string namespaceURI);
abstract member GetElementsByTagName : string * string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string * string -> System.Xml.XmlNodeList
Public Overridable Function GetElementsByTagName (localName As String, namespaceURI As String) As XmlNodeList

パラメーター

localName
String

一致する LocalName。The LocalName to match. 特殊値の "*" は、すべてのタグに一致します。The special value "*" matches all tags.

namespaceURI
String

一致する NamespaceURI。NamespaceURI to match.

戻り値

一致しているすべてのノードのリストを格納している XmlNodeListAn XmlNodeList containing a list of all matching nodes. 指定した localName および namespaceURI と一致するノードがない場合、返されるコレクションは空になります。If no nodes match the specified localName and namespaceURI, the returned collection will be empty.

注釈

ノードは、ドキュメントツリーに出現する順序で配置されます。The nodes are placed in the order in which they would be encountered in the document tree.

注意

GetElementsByTagName メソッドの代わりに、XmlNode.SelectNodes または XmlNode.SelectSingleNode メソッドを使用することをお勧めします。It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

適用対象