Edit

XElement.Name Property

  • Reference

Definition

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Gets or sets the name of this element.

public:
 property System::Xml::Linq::XName ^ Name { System::Xml::Linq::XName ^ get(); void set(System::Xml::Linq::XName ^ value); };
public System.Xml.Linq.XName Name { get; set; }
member this.Name : System.Xml.Linq.XName with get, set
Public Property Name As XName

Property Value

XName

An XName that contains the name of this element.

Examples

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

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

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

Remarks

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

Applies to

See also