Поделиться через

XmlElement.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, String)

Возвращает XmlNodeList, содержащий список всех элементов-потомков, соответствующих указанным значениям LocalName и NamespaceURI.
GetElementsByTagName(String)

Возвращает значение XmlNodeList, содержащее список всех элементов-потомков, соответствующих указанному имени Name.

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

Сопоставляемое локальное имя. Звездочка (*) — это специальное значение, которое соответствует всем тегам.

namespaceURI
String

Сопоставляемый URI пространства имен.

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

XmlNodeList

Класс XmlNodeList, содержащий список всех соответствующих узлов. Если соответствующие узлы отсутствуют, этот список пуст.

Комментарии

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

Примечание

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

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

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, содержащий список всех соответствующих узлов. Если соответствующие узлы отсутствуют, этот список пуст.

Примеры

В следующем примере показано получение и отображение всех названий книг.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->Load( "2books.xml" );
   
   // Get and display all the book titles.
   XmlElement^ root = doc->DocumentElement;
   XmlNodeList^ elemList = root->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()
  {
     XmlDocument doc = new XmlDocument();
     doc.Load("2books.xml");

     // Get and display all the book titles.
     XmlElement root = doc.DocumentElement;
     XmlNodeList elemList = root.GetElementsByTagName("title");
     for (int i=0; i < elemList.Count; i++)
     {
        Console.WriteLine(elemList[i].InnerXml);
     }
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("2books.xml")
                         
     ' Get and display all the book titles.
     Dim root as XmlElement = doc.DocumentElement
     Dim elemList as XmlNodeList = root.GetElementsByTagName("title")
     Dim i as integer
     for i=0  to elemList.Count-1
        Console.WriteLine(elemList.ItemOf(i).InnerXml)
     next
    
  end sub
end class

В этом примере файл 2books.xmlиспользуется в качестве входных данных.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Комментарии

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

Примечание

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

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