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