XNode.AddBeforeSelf Method (array<Object[])

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Adds the specified content immediately before this node.

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

Syntax

'Declaration
Public Sub AddBeforeSelf ( _
    ParamArray content As Object() _
)
public void AddBeforeSelf(
    params Object[] content
)

Parameters

  • content
    Type: array<System.Object[]
    A parameter list of content objects.

Exceptions

Exception Condition
InvalidOperationException

The parent is nulla null reference (Nothing in Visual Basic).

Remarks

For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects in the .NET Framework documentation.

This method will raise the Changed and the Changing events.

Examples

The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. This adds the results of a query to the tree in the desired location.

Dim output As New StringBuilder
Dim srcTree As XElement = _
        <Root>
            <Element1>1</Element1>
            <Element2>2</Element2>
            <Element3>3</Element3>
            <Element4>4</Element4>
            <Element5>5</Element5>
        </Root>

Dim xmlTree As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
        </Root>

Dim child1 As XElement = xmlTree.<Child1>(0)
child1.AddBeforeSelf( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el)

output.Append(xmlTree)
output.Append(Environment.NewLine)

OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
XElement srcTree = new XElement("Root",
    new XElement("Element1", 1),
    new XElement("Element2", 2),
    new XElement("Element3", 3),
    new XElement("Element4", 4),
    new XElement("Element5", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5)
);
XElement child1 = xmlTree.Element("Child1");
child1.AddBeforeSelf(
    from el in srcTree.Elements()
    where (int)el > 3
    select el
);
output.Append(xmlTree + Environment.NewLine);

OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.