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，它包含与指定名称匹配的所有子代元素的列表。

重载

GetElementsByTagName(String)	返回一个 XmlNodeList，它包含与指定 Name 匹配的所有子代元素的列表。
GetElementsByTagName(String, String)	返回一个 XmlNodeList，它包含与指定 LocalName 和 NamespaceURI 匹配的所有子代元素的列表。

GetElementsByTagName(String)

返回一个 XmlNodeList，它包含与指定 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

要匹配的限定名称。 它针对匹配节点的 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 方法。