XName.Get Método

Definição

Obtém um objeto XName.Gets an XName object.

Sobrecargas

Get(String)

Obtém um objeto XName de um nome expandido.Gets an XName object from an expanded name.

Get(String, String)

Obtém um objeto XName de um namespace e um nome local.Gets an XName object from a local name and a namespace.

Comentários

Esse método fornece sobrecargas que permitem criar um a XName partir de um nome XML expandido.This method provides overloads that allow you to create an XName from a expanded XML name. Você pode criar um XName de uma cadeia de caracteres no {namespace}localnameformulário ou de um namespace e um nome local, especificados separadamente.You can create an XName from a string in the form {namespace}localname, or from a namespace and a local name, specified separately.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres.A much more common and easier way to create an XName is to use the implicit conversion from string. Para criar um nome que esteja em um namespace, a abordagem comum é usar a sobrecarga de operador de adição que permite combinar um XNamespace objeto e uma cadeia de caracteres.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.

Para obter mais informações e exemplos, confira Como Crie um documento com namespaces (C#) (LINQ to XML).For more information and examples, see How to: Create a Document with Namespaces (C#) (LINQ to XML).

Para obter mais informações sobre como usar namespaces no Visual Basic, consulte namespaces no Visual Basic (LINQ to XML).For more information on using namespaces in Visual Basic, see Namespaces in Visual Basic (LINQ to XML).

Como XName os objetos são atomos, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName.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. Se não houver um existente XName, um novo será criado e inicializado.If there is no existing XName, a new one will be created and initialized.

Get(String)

Obtém um objeto XName de um nome expandido.Gets an XName object from an expanded name.

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.A String that contains an expanded XML name in the format {namespace}localname.

Retornos

Um objeto XName construído com base no nome expandido.An XName object constructed from the expanded name.

Exemplos

O exemplo a seguir mostra o uso desse método.The following example shows the use of this method.

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  

Este exemplo gera a seguinte saída:This example produces the following output:

<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.This method contains overloads that allow you to create an XName. Você pode criá-lo de um nome XML expandido no {namespace}localnameformulário ou de um namespace e um nome local, especificados separadamente.You can create it from a expanded XML name in the form {namespace}localname, or from a namespace and a local name, specified separately.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres.A much more common and easier way to create an XName is to use the implicit conversion from string.

Como XName os são atomos, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName.Because XName are atomized, if there is an existing XName with exactly the same name, the assigned variable will refer to the existing XName. Se não houver um existente XName, um novo será criado e inicializado.If there is no existing XName, a new one will be created and initialized.

Veja também

Get(String, String)

Obtém um objeto XName de um namespace e um nome local.Gets an XName object from a local name and a namespace.

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).A local (unqualified) name.

namespaceName
String

Um namespace de XML.An XML namespace.

Retornos

Um objeto XName criado no namespace e do nome local especificados.An XName object created from the specified local name and namespace.

Exemplos

O exemplo a seguir mostra o uso desse método.The following example shows the use of this method.

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  

Este exemplo gera a seguinte saída:This example produces the following output:

<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.This method contains overloads that allow you to create an XName. Você pode criá-lo de um nome XML expandido no {namespace}localnameformulário ou de um namespace e um nome local, especificados separadamente.You can create it from an expanded XML name in the form {namespace}localname, or from a namespace and a local name, specified separately.

Uma maneira muito mais comum e fácil de criar um XName é usar a conversão implícita da cadeia de caracteres.A much more common and easier way to create an XName is to use the implicit conversion from string.

Como XName os são atomos, se houver um existente XName com exatamente o mesmo nome, a variável atribuída fará referência ao existente XName.Because XName are atomized, if there is an existing XName with exactly the same name, the assigned variable will refer to the existing XName. Se não houver um existente XName, um novo será criado e inicializado.If there is no existing XName, a new one will be created and initialized.

Veja também

Aplica-se a