Extensions.Remove Method

Definition

Overloads

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.

Remove(IEnumerable<XAttribute>)

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

public static void Remove (this System.Collections.Generic.IEnumerable<System.Xml.Linq.XAttribute> source);
Parameters
source
IEnumerable<XAttribute>

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

Examples

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);  
Dim root As XElement = <Root Att1="1" Att2="2" Att3="3" Att4="4" Att5="5"/>  

Dim atList = From at In root.Attributes _  
             Where at.Value >= 3 _  
             Select at  

atList.Remove()  

Console.WriteLine(root)  

This example produces the following output:

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

Remarks

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).

Remove<T>(IEnumerable<T>)

Removes every node in the source collection from its parent node.

public static void Remove<T> (this System.Collections.Generic.IEnumerable<T> source) where T : System.Xml.Linq.XNode;
Type Parameters
T

The type of the objects in source, constrained to XNode.

Parameters
source
IEnumerable<T>

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

Examples

The following example retrieves a collection of elements. It then calls this method to remove the elements from their parent element.

XElement root = new XElement("Root",  
    new XElement("Data", 1),  
    new XElement("Data", 2),  
    new XElement("Data", 3),  
    new XElement("Data", 4),  
    new XElement("Data", 5)  
);  

IEnumerable<XElement> elList =  
    from el in root.Elements()  
    where (int)el >= 3  
    select el;  

elList.Remove();  

Console.WriteLine(root);  
Dim root As XElement = _  
    <Root>  
        <Data>1</Data>  
        <Data>2</Data>  
        <Data>3</Data>  
        <Data>4</Data>  
        <Data>5</Data>  
    </Root>  

Dim elList = From el In root.Elements _  
             Where el.Value >= 3 _  
             Select el  

elList.Remove()  

Console.WriteLine(root)  

This example produces the following output:

<Root>  
  <Data>1</Data>  
  <Data>2</Data>  
</Root>  

Remarks

This method uses snapshot semantics—that is, it copies the attributes in the source collection to a 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).

Applies to