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 метода.