XName.Get Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Obtém um objeto XName.

Sobrecargas

Get(String)	Obtém um objeto XName de um nome expandido.
Get(String, String)	Obtém um objeto XName de um namespace e um nome local.

Comentários

Esse método fornece sobrecargas que permitem criar um XName nome XML expandido. Você pode criar uma XName de uma cadeia de caracteres no formulário {namespace}localnameou em um namespace e um nome local especificados separadamente.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres. Para criar um nome que esteja em um namespace, a abordagem comum é usar a sobrecarga do operador de adição que permite combinar um XNamespace objeto e uma cadeia de caracteres.

Para obter mais informações e exemplos, consulte Como criar um documento com namespaces em C#.

Para obter mais informações sobre como usar namespaces, consulte Trabalhar com namespace XML.

Como XName os objetos são atomizados, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName. Se não houver existente XName, um novo será criado e inicializado.

Get(String)

Obtém um objeto XName de um nome expandido.

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

Parâmetros

expandedName

String

Um String que contém um nome XML expandido no formato {namespace} localname.

Retornos

XName

Um objeto XName construído com base no nome expandido.

Exemplos

O exemplo a seguir mostra o uso desse método.

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  

Esse exemplo gera a saída a seguir:

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

Comentários

Esse método contém sobrecargas que permitem criar um XName. Você pode criá-lo com base em um nome XML expandido no formulário {namespace}localnameou em um namespace e um nome local especificados separadamente.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres.

Como XName são atomizados, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName. Se não houver existente XName, um novo será criado e inicializado.

Confira também

• Visão geral do LINQ to XML

Get(String, String)

Obtém um objeto XName de um namespace e um nome local.

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

Parâmetros

localName

String

Um nome local (não qualificado).

namespaceName

String

Um namespace de XML.

Retornos

XName

Um objeto XName criado no namespace e do nome local especificados.

Exemplos

O exemplo a seguir mostra o uso desse método.

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  

Esse exemplo gera a saída a seguir:

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

Comentários

Esse método contém sobrecargas que permitem criar um XName. Você pode criá-lo com base em um nome XML expandido no formulário {namespace}localnameou em um namespace e um nome local especificados separadamente.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres.

Como XName são atomizados, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName. Se não houver existente XName, um novo será criado e inicializado.

Confira também

• Visão geral do LINQ to XML