XNode.Ancestors XNode.Ancestors XNode.Ancestors XNode.Ancestors Method

Определение

Возвращает коллекцию элементов предков данного узла.Returns a collection of the ancestor elements of this node.

Перегрузки

Ancestors() Ancestors() Ancestors() Ancestors()

Возвращает коллекцию элементов предков данного узла.Returns a collection of the ancestor elements of this node.

Ancestors(XName) Ancestors(XName) Ancestors(XName) Ancestors(XName)

Возвращает отфильтрованную коллекцию элементов предков данного узла.Returns a filtered collection of the ancestor elements of this node. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

Комментарии

При необходимости можно указать имя узла для фильтрации элементов-предков с определенным именем.Optionally a node name can be specified to filter for ancestor elements with a specific name.

Узлы в возвращаемой коллекции идут в обратном документном порядке.The nodes in the returned collection are in reverse document order.

Этот метод использует отложенное выполнение.This method uses deferred execution.

Ancestors() Ancestors() Ancestors() Ancestors()

Возвращает коллекцию элементов предков данного узла.Returns a collection of the ancestor elements of this node.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Ancestors();
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors ();
member this.Ancestors : unit -> seq<System.Xml.Linq.XElement>
Public Function Ancestors () As IEnumerable(Of XElement)

Возвраты

IEnumerable<T>, принадлежащий XElement элементов предков данного узла.An IEnumerable<T> of XElement of the ancestor elements of this node.

Примеры

В следующем примере этот метод используется для перечисления предков узла.The following example uses this method to enumerate the ancestors of a node.

XElement xmlTree = new XElement("Root",  
    new XElement("Child",   
        new XElement("GrandChild", "content")  
    )  
);  
IEnumerable<XElement> grandChild = xmlTree.Descendants("GrandChild");  
foreach (XElement el in grandChild.Ancestors())  
    Console.WriteLine(el.Name);  
Dim xmlTree As XElement = _   
        <Root>  
            <Child>  
                <GrandChild>content</GrandChild>  
            </Child>  
        </Root>  
  
Dim grandChild As IEnumerable(Of XElement) = xmlTree...<GrandChild>  
For Each el In grandChild.Ancestors()  
    Console.WriteLine(el.Name)  
Next  

В этом примере выводятся следующие данные:This example produces the following output:

Child  
Root  

Комментарии

Этот метод не возвращает сам себя в результатах.This method does not return itself in the results.

Узлы в возвращаемой коллекции идут в обратном документном порядке.The nodes in the returned collection are in reverse document order.

Этот метод использует отложенное выполнение.This method uses deferred execution.

Дополнительно

Ancestors(XName) Ancestors(XName) Ancestors(XName) Ancestors(XName)

Возвращает отфильтрованную коллекцию элементов предков данного узла.Returns a filtered collection of the ancestor elements of this node. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Ancestors(System::Xml::Linq::XName ^ name);
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors (System.Xml.Linq.XName name);
member this.Ancestors : System.Xml.Linq.XName -> seq<System.Xml.Linq.XElement>
Public Function Ancestors (name As XName) As IEnumerable(Of XElement)

Параметры

name
XName XName XName XName

XName для соответствия.The XName to match.

Возвраты

IEnumerable<T>, принадлежащий XElement элементов предков данного узла.An IEnumerable<T> of XElement of the ancestor elements of this node. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

Узлы в возвращаемой коллекции идут в обратном документном порядке.The nodes in the returned collection are in reverse document order.

Этот метод использует отложенное выполнение.This method uses deferred execution.

Примеры

В следующем примере используется этот метод.The following example uses this method.

XElement xmlTree = new XElement("Root",  
    new XElement("Child",   
        new XElement("GrandChild", "content")  
    )  
);  
IEnumerable<XElement> grandChild = xmlTree.Descendants("GrandChild");  
foreach (XElement el in grandChild.Ancestors("Child"))  
    Console.WriteLine(el.Name);  
Dim xmlTree As XElement = _   
        <Root>  
            <Child>  
                <GrandChild>content</GrandChild>  
            </Child>  
        </Root>  
  
Dim grandChild As IEnumerable(Of XElement) = xmlTree...<GrandChild>  
For Each el In grandChild.Ancestors("Child")  
    Console.WriteLine(el.Name)  
Next  

В этом примере выводятся следующие данные:This example produces the following output:

Child  

Комментарии

Этот метод не возвратит себя в результатах.This method will not return itself in the results.

Дополнительно

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