XmlDocument.GetElementsByTagName Метод

Определение

XmlNodeList Возвращает список всех потомков, которые соответствуют указанному имени.

Перегрузки

Имя Описание
GetElementsByTagName(String)

XmlNodeList Возвращает список всех потомков, которые соответствуют указанному.Name

GetElementsByTagName(String, String)

XmlNodeList Возвращает список всех потомков, которые соответствуют указанному LocalName иNamespaceURI.

GetElementsByTagName(String)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

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 список всех соответствующих узлов. Если узлы не соответствуют name, возвращаемая коллекция будет пуста.

Примеры

В следующем примере создается XmlDocument объект и используется GetElementsByTagName метод и результирующий XmlNodeList объект для отображения всех названий книг.

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>

Комментарии

Узлы помещаются в порядок, в котором они будут обнаружены в документе.

Note

Рекомендуется использовать XmlNode.SelectNodes метод или XmlNode.SelectSingleNode метод вместо GetElementsByTagName метода.

Применяется к

GetElementsByTagName(String, String)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

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

ИмяspaceURI для сопоставления.

Возвращаемое значение

Содержит XmlNodeList список всех соответствующих узлов. Если узлы не соответствуют указанному localName и namespaceURIвозвращаемая коллекция будет пуста.

Комментарии

Узлы помещаются в порядок, в котором они будут обнаружены в дереве документов.

Note

Рекомендуется использовать XmlNode.SelectNodes метод или XmlNode.SelectSingleNode метод вместо GetElementsByTagName метода.

Применяется к