XName.Get Method

Definition

Overloads

Remarks

This method provides overloads that allow you to create an XName from a expanded XML name. You can create an XName from a string in the form {namespace}localname, or from a namespace and a local name, specified separately.

A much more common and easier way to create an XName is to use the implicit conversion from string. To create a name that is in a namespace, the common approach is to use the addition operator overload that allows you to combine an XNamespace object and a string.

For more information and examples, see How to create a document with namespaces in C#.

For more information on using namespaces, see Work with XML namespace.

Because XName objects are atomized, if there is an existing XName with exactly the same name, the assigned variable will refer to the existing XName. If there is no existing XName, a new one will be created and initialized.

public:
 static System::Xml::Linq::XName ^ Get(System::String ^ expandedName);

public static System.Xml.Linq.XName Get (string expandedName);

static member Get : string -> System.Xml.Linq.XName

Public Shared Function Get (expandedName As String) As XName

XName name = XName.Get("{http://www.adventure-works.com}Root");
XElement el = new XElement(name, "content");
Console.WriteLine(el);

// This is the preferred approach for specifying the XName in the
// constructor of XElement.
XNamespace aw = "http://www.adventure-works.com";
XElement el2 = new XElement(aw + "Root", "content");
Console.WriteLine(el2);

Imports <xmlns="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim name As XName = XName.Get("{http://www.adventure-works.com}Root")
        Dim el As XElement = New XElement(name, "content")
        Console.WriteLine(el)

        ' The preferred approach for specifying an XName in a namespace
        ' for Visual Basic is to import a global namespace.
        Dim el2 As XElement = <Root>content</Root>
        Console.WriteLine(el2)
    End Sub
End Module

<Root xmlns="http://www.adventure-works.com">content</Root>
<Root xmlns="http://www.adventure-works.com">content</Root>

public:
 static System::Xml::Linq::XName ^ Get(System::String ^ localName, System::String ^ namespaceName);

public static System.Xml.Linq.XName Get (string localName, string namespaceName);

static member Get : string * string -> System.Xml.Linq.XName

Public Shared Function Get (localName As String, namespaceName As String) As XName

XName name = XName.Get("Root", "http://www.adventure-works.com");
XElement el = new XElement(name, "content");
Console.WriteLine(el);

// This is the preferred form.
XNamespace aw = "http://www.adventure-works.com";
XElement el2 = new XElement(aw + "Root", "content");
Console.WriteLine(el2);

Imports <xmlns="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim name As XName = XName.Get("{http://www.adventure-works.com}Root")
        Dim el As XElement = New XElement(name, "content")
        Console.WriteLine(el)

        ' The preferred approach for specifying an XName in a namespace
        ' for Visual Basic is to import a global namespace.
        Dim el2 As XElement = <Root>content</Root>
        Console.WriteLine(el2)
    End Sub
End Module

<Root xmlns="http://www.adventure-works.com">content</Root>
<Root xmlns="http://www.adventure-works.com">content</Root>