XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName Method

定義

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

オーバーロード

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

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

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

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

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

指定した Name に一致するすべての子孫の要素のリストを格納している XmlNodeList を返します。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 String String 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 'Main 
End Class 'Sample

この例は、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.

注意

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

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

指定した LocalName および NamespaceURI に一致するすべての子孫の要素のリストを格納している XmlNodeList を返します。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 String String String

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

namespaceURI
String String String 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.

注意

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

適用対象