Extensions.XPathSelectElements Метод

  • Ссылка

Определение

Пространство имен:
System.Xml.XPath
Сборка:
System.Xml.XPath.XDocument.dll
Сборка:
System.Xml.Linq.dll
Сборка:
netstandard.dll

Выбирает коллекцию элементов с помощью выражения XPath.

Перегрузки

XPathSelectElements(XNode, String)

Выбирает коллекцию элементов с помощью выражения XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Выбирает коллекцию элементов с помощью выражения XPath, разрешая префиксы пространства имен с помощью указанного IXmlNamespaceResolver.

Комментарии

Хотя порядок возвращаемых коллекций не указан в рекомендации XML XPath Language 1.0, этот метод расширения возвращает узлы в порядке документа.

Обратите внимание, что узлы возвращаются в порядке документа, даже если используется обратная ось, напримерpreceding-sibling.ancestor-or-self

XPathSelectElements(XNode, String)

Выбирает коллекцию элементов с помощью выражения XPath.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ XPathSelectElements(System::Xml::Linq::XNode ^ node, System::String ^ expression);
public static System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> XPathSelectElements (this System.Xml.Linq.XNode node, string expression);
static member XPathSelectElements : System.Xml.Linq.XNode * string -> seq<System.Xml.Linq.XElement>
<Extension()>
Public Function XPathSelectElements (node As XNode, expression As String) As IEnumerable(Of XElement)

Параметры

node
XNode

XNode, в котором вычисляется выражение XPath.

expression
String

String, содержащая выражение XPath.

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

IEnumerable<XElement>

IEnumerable<T> для XElement, содержащего выбранные элементы.

Примеры

В следующем примере создается небольшое XML-дерево и для получения набора элементов используется запрос XPathSelectElements.

                XElement root = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child1", 2),  
    new XElement("Child1", 3),  
    new XElement("Child2", 4),  
    new XElement("Child2", 5),  
    new XElement("Child2", 6)  
);  
IEnumerable<XElement> list = root.XPathSelectElements("./Child2");  
foreach (XElement el in list)  
    Console.WriteLine(el);  

                Dim root As XElement = _  
    <Root>  
        <Child1>1</Child1>  
        <Child1>2</Child1>  
        <Child1>3</Child1>  
        <Child2>4</Child2>  
        <Child2>5</Child2>  
        <Child2>6</Child2>  
    </Root>  
Dim list As IEnumerable(Of XElement) = root.XPathSelectElements("./Child2")  
For Each el As XElement In list  
    Console.WriteLine(el)  
Next

В этом примере выводятся следующие данные:

<Child2>4</Child2>  
<Child2>5</Child2>  
<Child2>6</Child2>

Комментарии

Хотя порядок возвращаемых коллекций не указан в рекомендации XML XPath Language 1.0, этот метод расширения возвращает узлы в порядке документа.

Обратите внимание, что узлы возвращаются в порядке документа, даже если используется обратная ось, напримерpreceding-sibling.ancestor-or-self

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

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Выбирает коллекцию элементов с помощью выражения XPath, разрешая префиксы пространства имен с помощью указанного IXmlNamespaceResolver.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ XPathSelectElements(System::Xml::Linq::XNode ^ node, System::String ^ expression, System::Xml::IXmlNamespaceResolver ^ resolver);
public static System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> XPathSelectElements (this System.Xml.Linq.XNode node, string expression, System.Xml.IXmlNamespaceResolver? resolver);
public static System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> XPathSelectElements (this System.Xml.Linq.XNode node, string expression, System.Xml.IXmlNamespaceResolver resolver);
static member XPathSelectElements : System.Xml.Linq.XNode * string * System.Xml.IXmlNamespaceResolver -> seq<System.Xml.Linq.XElement>
<Extension()>
Public Function XPathSelectElements (node As XNode, expression As String, resolver As IXmlNamespaceResolver) As IEnumerable(Of XElement)

Параметры

node
XNode

XNode, в котором вычисляется выражение XPath.

expression
String

String, содержащая выражение XPath.

resolver
IXmlNamespaceResolver

IXmlNamespaceResolver для префиксов пространств имен в выражении XPath.

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

IEnumerable<XElement>

IEnumerable<T> для XElement, содержащего выбранные элементы.

Примеры

В этом примере создается XML-дерево, содержащее пространство имен. Для считывания XML-документа используется XmlReader. Затем в примере происходит получение XmlNameTable из XmlReader и XmlNamespaceManager из XmlNameTable. Он используется XmlNamespaceManager при выборе списка элементов.

                string markup = @"  
<aw:Root xmlns:aw='http://www.adventure-works.com'>  
    <aw:Child1>child one data 1</aw:Child1>  
    <aw:Child1>child one data 2</aw:Child1>  
    <aw:Child1>child one data 3</aw:Child1>  
    <aw:Child2>child two data 4</aw:Child2>  
    <aw:Child2>child two data 5</aw:Child2>  
    <aw:Child2>child two data 6</aw:Child2>  
</aw:Root>";  
XmlReader reader = XmlReader.Create(new StringReader(markup));  
XElement root = XElement.Load(reader);  
XmlNameTable nameTable = reader.NameTable;  
XmlNamespaceManager namespaceManager = new XmlNamespaceManager(nameTable);  
namespaceManager.AddNamespace("aw", "http://www.adventure-works.com");  
IEnumerable<XElement> elements = root.XPathSelectElements("./aw:Child1", namespaceManager);  
foreach (XElement el in elements)  
    Console.WriteLine(el);  

                Dim markup As XElement = _  
<aw:Root xmlns:aw="http://www.adventure-works.com">  
    <aw:Child1>child one data 1</aw:Child1>  
    <aw:Child1>child one data 2</aw:Child1>  
    <aw:Child1>child one data 3</aw:Child1>  
    <aw:Child2>child two data 4</aw:Child2>  
    <aw:Child2>child two data 5</aw:Child2>  
    <aw:Child2>child two data 6</aw:Child2>  
</aw:Root>  
Dim reader As XmlReader = markup.CreateReader  
Dim nameTable As XmlNameTable = reader.NameTable  
Dim namespaceManager As XmlNamespaceManager = New XmlNamespaceManager(nameTable)  
namespaceManager.AddNamespace("aw", "http://www.adventure-works.com")  
Dim elements As IEnumerable(Of XElement) = markup.XPathSelectElements("./aw:Child1", namespaceManager)  
For Each el As XElement In elements  
    Console.WriteLine(el)  
Next

В этом примере выводятся следующие данные:

<aw:Child1 xmlns:aw="http://www.adventure-works.com">child one data 1</aw:Child1>  
<aw:Child1 xmlns:aw="http://www.adventure-works.com">child one data 2</aw:Child1>  
<aw:Child1 xmlns:aw="http://www.adventure-works.com">child one data 3</aw:Child1>

Комментарии

Этот метод можно использовать для оценки выражений XPath, содержащих префиксы пространства имен.

Хотя порядок возвращаемых коллекций не указан в рекомендации XML XPath Language 1.0, этот метод расширения возвращает узлы в порядке документа.

Обратите внимание, что узлы возвращаются в порядке документа, даже если используется обратная ось, напримерpreceding-sibling.ancestor-or-self

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