Export (0) Print
Expand All

XName.Get Method (String, String)

Gets an XName object from a local name and a namespace.

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

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

Parameters

localName
Type: System.String

A local (unqualified) name.

namespaceName
Type: System.String

An XML namespace.

Return Value

Type: System.Xml.Linq.XName
An XName object created from the specified local name and namespace.

This method contains overloads that allow you to create an XName. You can create it from an expanded XML name 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.

Because XName 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.

The following example shows the use of this method.

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

This example produces the following output:

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft