Export (0) Print
Expand All

XElement Constructor

Initializes a new instance of the XElement class.

This member is overloaded. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.

  Name Description
Public method XElement(XElement) Initializes a new instance of the XElement class from another XElement object.
Public method XElement(XName) Initializes a new instance of the XElement class with the specified name.
Public method XElement(XStreamingElement) Initializes a new instance of the XElement class from an XStreamingElement object.
Public method XElement(XName, Object) Initializes a new instance of the XElement class with the specified name and content.
Public method XElement(XName, Object()) Initializes a new instance of the XElement class with the specified name and content.
Top

For details about the valid content that can be passed to this constructor, see Valid Content of XElement and XDocument Objects.

There is an implicit conversion from string to XName. Typical use of this constructor is to specify a string as the parameter instead of creating a new XName.

When creating an element in a namespace, typical use is to use the addition operator overload with an XNamespace and a string to create an XName. For more information, see Working with XML Namespaces.

The following example creates an XML tree. The content of the new element comes from a LINQ query.

Dim xmlTree1 As XElement = _ 
        <Root>
            <Child>1</Child>
            <Child>2</Child>
            <Child>3</Child>
            <Child>4</Child>
            <Child>5</Child>
            <Child>6</Child>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

Console.WriteLine(xmlTree2)

This example produces the following output:

<Root>
  <Child>3</Child>
  <Child>4</Child>
  <Child>5</Child>
</Root>
Show:
© 2014 Microsoft