XmlDocument.GetElementsByTagName 方法

定義

命名空間:

System.Xml

組件:

System.Xml.dll, System.Xml.XmlDocument.dll

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.XmlDocument.dll

組件:

System.Xml.dll

組件:

netstandard.dll

傳回 XmlNodeList，其中包含符合指定名稱之所有子代 (Descendant) 項目清單。

多載

GetElementsByTagName(String)	傳回 XmlNodeList，其中包含符合指定 Name 之所有子代 (Descendant) 項目的清單。
GetElementsByTagName(String, String)	傳回 XmlNodeList，其中包含符合指定之 LocalName 和 NamespaceURI 的所有子代元素的清單。

GetElementsByTagName(String)

傳回 XmlNodeList，其中包含符合指定 Name 之所有子代 (Descendant) 項目的清單。

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

要相符的限定名稱。 它會與符合節點的 Name 屬性比對。 特殊值 "*" 與所有標記相符。

傳回

XmlNodeList

XmlNodeList，包含所有符合節點的清單。 如果沒有節點符合 name，就會傳回空的集合。

範例

下列範例會 XmlDocument 建立 物件，並使用 GetElementsByTagName 方法和產生的 XmlNodeList 物件來顯示所有書籍標題。

#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.Xml;

public class Sample1
{
    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 檔案做為輸入。

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

備註

節點會依檔中遇到的順序排列。

注意

建議您使用 XmlNode.SelectNodes 或 XmlNode.SelectSingleNode 方法， GetElementsByTagName 而不是 方法。

GetElementsByTagName(String, String)

傳回 XmlNodeList，其中包含符合指定之 LocalName 和 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。 特殊值 "*" 與所有標記相符。

namespaceURI

String

要比對的 NamespaceURI。

傳回

XmlNodeList

XmlNodeList，包含所有符合節點的清單。 如果沒有節點符合指定的 localName 及 namespaceURI，就會傳回空的集合。

備註

節點會依檔樹狀結構中遇到的順序排列。

注意

建議您使用 XmlNode.SelectNodes 或 XmlNode.SelectSingleNode 方法， GetElementsByTagName 而不是 方法。