XName.Get Metoda

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

XName Pobiera obiekt.

Przeciążenia

Get(String)	XName Pobiera obiekt z rozwiniętej nazwy.
Get(String, String)	XName Pobiera obiekt z lokalnej nazwy i przestrzeni nazw.

Uwagi

Ta metoda zapewnia przeciążenia, które umożliwiają utworzenie elementu XName na podstawie rozszerzonej nazwy XML. Możesz utworzyć element XName na podstawie ciągu w formularzu {namespace}localnamelub z przestrzeni nazw i lokalnej nazwy określonej oddzielnie.

Znacznie częstszym i łatwiejszym sposobem utworzenia obiektu XName jest użycie niejawnej konwersji z ciągu. Aby utworzyć nazwę w przestrzeni nazw, typowym podejściem jest użycie przeciążenia operatora dodawania, które umożliwia łączenie XNamespace obiektu i ciągu.

Aby uzyskać więcej informacji i przykładów, zobacz Jak utworzyć dokument z przestrzeniami nazw w języku C#.

Aby uzyskać więcej informacji na temat używania przestrzeni nazw, zobacz Praca z przestrzenią nazw XML.

Ponieważ XName obiekty są atomizowane, jeśli istnieje dokładnie XName taka sama nazwa, przypisana zmienna będzie odwoływać się do istniejącej XName. Jeśli nie ma istniejącej XName, zostanie utworzony i zainicjowany nowy.

Get(String)

XName Pobiera obiekt z rozwiniętej nazwy.

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

Parametry

expandedName

String

Element String zawierający rozszerzoną nazwę XML w formacie {namespace}localname.

Zwraca

XName

XName Obiekt skonstruowany z rozwiniętej nazwy.

Przykłady

W poniższym przykładzie pokazano użycie tej metody.

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

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda zawiera przeciążenia, które umożliwiają utworzenie elementu XName. Można go utworzyć na podstawie rozwiniętej nazwy XML w postaci {namespace}localname, lub z przestrzeni nazw i nazwy lokalnej, określonej oddzielnie.

Znacznie częstszym i łatwiejszym sposobem utworzenia obiektu XName jest użycie niejawnej konwersji z ciągu.

Ponieważ XName są atomizowane, jeśli istnieje dokładnie XName taka sama nazwa, przypisana zmienna będzie odwoływać się do istniejącej XName. Jeśli nie ma istniejącej XName, zostanie utworzony i zainicjowany nowy.

Zobacz też

• LINQ to XML — przegląd

Get(String, String)

XName Pobiera obiekt z lokalnej nazwy i przestrzeni nazw.

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

Parametry

localName

String

Lokalna (niekwalifikowana) nazwa.

namespaceName

String

Przestrzeń nazw XML.

Zwraca

XName

XName Obiekt utworzony na podstawie określonej lokalnej nazwy i przestrzeni nazw.

Przykłady

W poniższym przykładzie pokazano użycie tej metody.

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

Ten przykład generuje następujące wyniki:

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

Uwagi

Ta metoda zawiera przeciążenia, które umożliwiają utworzenie elementu XName. Możesz utworzyć ją na podstawie rozwiniętej nazwy XML w postaci {namespace}localname, lub z przestrzeni nazw i nazwy lokalnej, określonej oddzielnie.

Znacznie częstszym i łatwiejszym sposobem utworzenia obiektu XName jest użycie niejawnej konwersji z ciągu.

Ponieważ XName są atomizowane, jeśli istnieje dokładnie XName taka sama nazwa, przypisana zmienna będzie odwoływać się do istniejącej XName. Jeśli nie ma istniejącej XName, zostanie utworzony i zainicjowany nowy.

Zobacz też

• LINQ to XML — przegląd