XElement Constructor (XName, array<Object[])
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Initializes a new instance of the XElement class with the specified name and content.
Namespace: System.Xml.Linq
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
'Declaration
Public Sub New ( _
name As XName, _
ParamArray content As Object() _
)
public XElement(
XName name,
params Object[] content
)
Parameters
- name
Type: System.Xml.Linq.XName
An XName that contains the element name.
- content
Type: array<System.Object[]
The initial content of the element.
Remarks
This constructor creates an element with the specified content and attributes.
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 Namespaces in the .NET Framework documentation.
For more information about the valid content that can be passed to this constructor, see Valid Content of XElement and XDocument Objects in the .NET Framework documentation.
Examples
The following example creates an XML tree. The content of the new element comes from a LINQ query.
Dim output As New StringBuilder
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
output.Append(xmlTree2)
output.Append(Environment.NewLine)
OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
XElement xmlTree1 = new XElement("Root",
new XElement("Child1", 1),
new XElement("Child2", 2),
new XElement("Child3", 3),
new XElement("Child4", 4),
new XElement("Child5", 5),
new XElement("Child6", 6)
);
XElement xmlTree2 = new XElement("Root",
from el in xmlTree1.Elements()
where ((int)el >= 3 && (int)el <= 5)
select el
);
output.Append(xmlTree2 + 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.
See Also