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

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Share via