XName-Klasse

XName enthält keine öffentlichen Konstruktoren. Stattdessen stellt diese Klasse eine implizite Konvertierung von String bereit, die es Ihnen ermöglicht, einen XName zu erstellen. Am häufigsten wird diese Konvertierung beim Erstellen eines Elements oder Attributs verwendet: Das erste Argument für den XElement-Konstruktor ist ein XName. Sie nutzen die implizite Konvertierung, wenn Sie eine Zeichenfolge übergeben. Im folgenden Code wird ein Element mit einem Namen erstellt, der sich in keinem Namespace befindet:

XElement root = new XElement("ElementName", "content");
Console.WriteLine(root);

In Visual Basic empfiehlt sich die Verwendung von XML-Literalen:

Dim root As XElement = <ElementName>content</ElementName>
Console.WriteLine(root)

Mit diesem Beispiel wird die folgende Ausgabe erzeugt:

<ElementName>content</ElementName>

Beim Zuweisen einer Zeichenfolge zu einem XName wird die implizite Konvertierung von String verwendet.

Im Visual Basic-Beispiel wird das XElement mit XML-Literalen erstellt. Obwohl XML-Literale verwendet werden, wird für das XElement ein XName-Objekt erstellt.

Sie können außerdem die Get-Methode für ein XName-Objekt aufrufen. Es wird jedoch empfohlen, die implizite Konvertierung von string zu verwenden.

XName kann sich wie XML in einem Namespace oder in keinem Namespace befinden.

Für C# wird zum Erstellen eines XName in einem Namespace empfohlen, das XNamespace-Objekt zu deklarieren und dann die Überschreibung des Additionsoperators zu verwenden.

Für Visual Basic wird zum Erstellen von XML in einem Namespace empfohlen, XML-Literale und globale Namespacedeklarationen zu verwenden.

XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "ElementName", "content");
Console.WriteLine(root);

Dieses Beispiel erzeugt folgende Ausgabe:

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

Die Namespace-Eigenschaft eines XName-Objekts ist unter keinen Umständen NULL. Wenn sich der XName in keinem Namespace befindet, wird die Namespace-Eigenschaft auf None festgelegt. Der folgende Code zeigt dies:

XElement root = new XElement("ElementName", "content");
if (root.Name.Namespace == XNamespace.None)
    Console.WriteLine("The element is in no namespace.");
else
    Console.WriteLine("The element is in a namespace.");

Dieses Beispiel erzeugt folgende Ausgabe:

The element is in no namespace.

Sie können auch einen XName aus einem erweiterten XML-Namen im Format {namespace}localname erstellen:

XElement root = new XElement("{http://www.adventure-works.com}ElementName", "content");
Console.WriteLine(root);

Dieses Beispiel erzeugt folgende Ausgabe:

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

Beachten Sie, dass das Erstellen eines XName über einen erweiterten Namen weniger effizient ist, als ein XNamespace-Objekt zu erstellen und die Überschreibung des Additionsoperators zu verwenden. Es ist auch weniger effizient, als in Visual Basic einen globalen Namespace zu importieren und XML-Literale zu verwenden.

Wenn Sie einen XName unter Verwendung eines erweiterten Namens erstellen, muss LINQ to XML die atomisierte Instanz eines Namespaces suchen. Dieser Vorgang muss für jede Verwendung eines erweiterten Namens wiederholt werden. Diese zusätzliche Zeit ist beim Schreiben von LINQ-Abfragen wahrscheinlich vernachlässigbar, kann jedoch beim Erstellen einer großen XML-Struktur bedeutsam sein.

XName-Objekte sind mit Sicherheit atomisiert. Das bedeutet, wenn zwei XName-Objekte über genau denselben Namespace und genau denselben lokalen Namen verfügen, handelt es sich um dieselbe Instanz. Der Gleichheits- und Vergleichsoperator werden explizit für diesen Zweck bereitgestellt.

Neben anderen Vorteilen ermöglicht dieses Feature die schnellere Ausführung von Abfragen. Beim Filtern nach dem Namen von Elementen oder Attributen erfolgen die in Prädikaten angegebenen Vergleiche als Identitätsvergleich und nicht als Wertvergleich. Es lässt sich viel schneller bestimmen, ob zwei Verweise tatsächlich auf dasselbe Objekt verweisen, als zwei Zeichenfolgen zu vergleichen.