XmlElement.GetElementsByTagName Метод

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.XmlDocument.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XmlDocument.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

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

Перегрузки

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

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

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

GetElementsByTagName(String, String)

Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.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

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

namespaceURI
String

Универсальный код ресурса (URI) пространства имен для сопоставления.

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

XmlNodeList

Содержит XmlNodeList список всех соответствующих узлов. Список пуст, если отсутствуют соответствующие узлы.

Комментарии

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

Note

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

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

GetElementsByTagName(String)

Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.cs
Исходный код:
XmlElement.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

Содержит XmlNodeList список всех соответствующих узлов. Список пуст, если отсутствуют соответствующие узлы.

Примеры

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

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 обходе дерева.

Note

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

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