Extensions Class (System.Xml.Linq)

Switch View :
Classic
Lightweight
ScriptFree
.NET Framework Class Library
Extensions Class

Contains the LINQ to XML extension methods.

Inheritance Hierarchy
System.Object
  System.Xml.Linq.Extensions

Namespace:  System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
Visual Basic
<ExtensionAttribute> _
Public NotInheritable Class Extensions
C#
public static class Extensions
Visual C++
[ExtensionAttribute]
public ref class Extensions abstract sealed
F#
[<AbstractClass>]
[<Sealed>]
type Extensions =  class end

The Extensions type exposes the following members.

Methods
  Name Description
Public method Static member Supported by the XNA Framework Ancestors<T>(IEnumerable<T>) Returns a collection of elements that contains the ancestors of every node in the source collection.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework Attributes(IEnumerable<XElement>) Returns a collection of the attributes of every element in the source collection.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework DescendantNodes<T> Returns a collection of the descendant nodes of every document and element in the source collection.
Public method Static member Supported by the XNA Framework DescendantNodesAndSelf Returns a collection of nodes that contains every element in the source collection, and the descendant nodes of every element in the source collection.
Public method Static member Supported by the XNA Framework Descendants<T>(IEnumerable<T>) Returns a collection of elements that contains the descendant elements of every element and document in the source collection.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework Elements<T>(IEnumerable<T>) Returns a collection of the child elements of every element and document in the source collection.
Public method Static member Supported by the XNA Framework 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.
Public method Static member Supported by the XNA Framework InDocumentOrder<T> Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.
Public method Static member Supported by the XNA Framework Nodes<T> Returns a collection of the child nodes of every document and element in the source collection.
Public method Static member Supported by the XNA Framework Remove(IEnumerable<XAttribute>) Removes every attribute in the source collection from its parent element.
Public method Static member Supported by the XNA Framework Remove<T>(IEnumerable<T>) Removes every node in the source collection from its parent node.
Top
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.

Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also

Reference

System.Xml.Linq Namespace

Other Resources

LINQ to XML
LINQ to XML Axes
Removing Elements, Attributes, and Nodes from an XML Tree
Extension Methods (C# Programming Guide)
Community Content

Thomas Lee
what is axis method ?
what is an axis method please can you provide or link to a definition

thanks
[tfl - 19 07 10] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio  : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell     : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&