Extensions.Remove Method (IEnumerable<XAttribute>)

Removes every attribute in the source collection from its parent element.

Namespace:  System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

public static void Remove(
	this IEnumerable<XAttribute> source
)

Parameters

source
Type: System.Collections.Generic.IEnumerable<XAttribute>

An IEnumerable<T> of XAttribute that contains the source collection.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerable<XAttribute>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

This method uses snapshot semantics—that is, it copies the attributes in the source collection to a System.Collections.Generic.List<T> before disconnecting them from their parents. This is required to avoid issues with mixed imperative/declarative code. For more information, see Mixed Declarative Code/Imperative Code Bugs (LINQ to XML).

The following example retrieves a collection of attributes, and then calls this method to remove them from their parent elements.

XElement root = new XElement("Root",
    new XAttribute("Att1", 1),
    new XAttribute("Att2", 2),
    new XAttribute("Att3", 3),
    new XAttribute("Att4", 4),
    new XAttribute("Att5", 5)
);

IEnumerable<XAttribute> atList =
    from at in root.Attributes()
    where (int)at >= 3
    select at;

atList.Remove();

Console.WriteLine(root);

This example produces the following output:

<Root Att1="1" Att2="2" />

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft