Extensions Class

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

Extensions.cs

Contains the LINQ to XML extension methods.

public ref class Extensions abstract sealed

public static class Extensions

type Extensions = class

Public Module Extensions

Inheritance

Object

Extensions

Remarks

Most of the LINQ to XML extension methods are axis methods that are used in LINQ queries. The methods in this class operate on collections and return collections. These methods enumerate the source collection, call the appropriate axis method on each item in the collection, and concatenate the results.

The two Remove extension methods are not axis methods, however. These methods remove attributes or nodes from the XML tree.

Note that there is another category of axis methods, implemented in the XElement, XDocument, and XNode classes. These other axis methods operate on a single object, and return a collection of XElement, XAttribute, or XNode objects.

All of the axis extension methods use deferred execution.

Methods

Ancestors<T>(IEnumerable<T>)	Returns a collection of elements that contains the ancestors of every node in the source collection.
Ancestors<T>(IEnumerable<T>, XName)	Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Only elements that have a matching XName are included in the collection.
AncestorsAndSelf(IEnumerable<XElement>)	Returns a collection of elements that contains every element in the source collection, and the ancestors of every element in the source collection.
AncestorsAndSelf(IEnumerable<XElement>, XName)	Returns a filtered collection of elements that contains every element in the source collection, and the ancestors of every element in the source collection. Only elements that have a matching XName are included in the collection.
Attributes(IEnumerable<XElement>)	Returns a collection of the attributes of every element in the source collection.
Attributes(IEnumerable<XElement>, XName)	Returns a filtered collection of the attributes of every element in the source collection. Only elements that have a matching XName are included in the collection.
DescendantNodes<T>(IEnumerable<T>)	Returns a collection of the descendant nodes of every document and element in the source collection.
DescendantNodesAndSelf(IEnumerable<XElement>)	Returns a collection of nodes that contains every element in the source collection, and the descendant nodes of every element in the source collection.
Descendants<T>(IEnumerable<T>)	Returns a collection of elements that contains the descendant elements of every element and document in the source collection.
Descendants<T>(IEnumerable<T>, XName)	Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Only elements that have a matching XName are included in the collection.
DescendantsAndSelf(IEnumerable<XElement>)	Returns a collection of elements that contains every element in the source collection, and the descendent elements of every element in the source collection.
DescendantsAndSelf(IEnumerable<XElement>, XName)	Returns a filtered collection of elements that contains every element in the source collection, and the descendents of every element in the source collection. Only elements that have a matching XName are included in the collection.
Elements<T>(IEnumerable<T>)	Returns a collection of the child elements of every element and document in the source collection.
Elements<T>(IEnumerable<T>, XName)	Returns a filtered collection of the child elements of every element and document in the source collection. Only elements that have a matching XName are included in the collection.
InDocumentOrder<T>(IEnumerable<T>)	Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.
Nodes<T>(IEnumerable<T>)	Returns a collection of the child nodes of every document and element in the source collection.
Remove(IEnumerable<XAttribute>)	Removes every attribute in the source collection from its parent element.
Remove<T>(IEnumerable<T>)	Removes every node in the source collection from its parent node.

See also

• LINQ to XML overview
• LINQ to XML axes overview
• Remove elements, attributes, and nodes from an XML tree
• Extension Methods (C# Programming Guide)