XElement.Name Property (System.Xml.Linq)

Switch View :
ScriptFree
.NET Framework Class Library
XElement.Name Property

Gets or sets the name of this element.

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

Visual Basic
Public Property Name As XName
	Get
	Set
C#
public XName Name { get; set; }
Visual C++
public:
property XName^ Name {
	XName^ get ();
	void set (XName^ value);
}
F#
member Name : XName with get, set

Property Value

Type: System.Xml.Linq.XName
An XName that contains the name of this element.
Remarks

Setting this property will raise the Changed and the Changing events.

Examples

The following example uses this property to determine the name of an element.

C#
XElement el1 = new XElement("Root", "content");
Console.WriteLine(el1.Name);

XNamespace ns = "http://www.adventure-works.com";
XElement el2 = new XElement(ns + "Root", "content");
Console.WriteLine(el2.Name);
Console.WriteLine(el2.Name.Namespace);
Console.WriteLine(el2.Name.LocalName);
el2.Name = ns + "NewName";
Console.WriteLine(el2.Name);
Visual Basic
Imports <xmlns:aw="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim el1 As XElement = <Root>content</Root>
        Console.WriteLine(el1.Name)

        Dim el2 As XElement = <aw:Root>content</aw:Root>
        Console.WriteLine(el2.Name)
        Console.WriteLine(el2.Name.Namespace)
        Console.WriteLine(el2.Name.LocalName)
        Dim aw as XNamespace = GetXmlNamespace(aw)
        el2.Name = aw + "NewName"
        Console.WriteLine(el2.Name)
    End Sub
End Module

This example produces the following output:

Root
{http://www.adventure-works.com}Root
http://www.adventure-works.com
Root
{http://www.adventure-works.com}NewName
Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference

Other Resources