LINQ to XML Teil 1 – Erstellen einer XML Datei

Einleitung

LINQ ist die Abkürzung für Language INtegrated Query, dies ist eine Abfragesprache die mit C# 3.0 in .NET eingeführt wurde. Der Vorteil von LINQ ist, dass die Abfragen nicht mehr per String im Quelltext eingebunden werden müssen. Die Abfragen werden bei LINQ durch den Compiler geprüft und optimiert. Dies bedeutet, eine fehlerhafte Abfrage kann nicht kompiliert werden. Der Fehler kann so sehr früh erkannt werden und tritt nicht erst zur Laufzeit auf, eventuell sogar erst beim Kunden.
Mit LINQ können nicht nur Datenbanken abgefragt werden, sondern auch DataSets, Objekte oder XML. In dieser Artikelserie geht es ausschließlich um die Abfrage von XML.

Erstellen eines XML Dokuments

Ein XML Dokument wird bei der Verwendung nicht durch die Klasse XMLDocument repräsentiert sondern durch die Klasse XDocument. Um ein minimales XML Dokument zu erstellen, muss ein Objekt vom Typ XDocument wie folgt instanziiert werden:

var Adressen = new XDocument( 
    new XElement("Container", "Inhalt") 
    ); 

Hinweis:
In XML Dateien dürfen 4 Zeichen nicht direkt verwendet werden: „<“, „>“, das Apostroph und die Anführungszeichen. Diese Zeichen werden automatisch umgewandelt. Zum Beispiel wird aus < &gt;
Der Konstruktor des XDocument erwartet im einfachsten Fall ein Array von Objekten. Es wird in diesem Beispiel nur ein XElement erstellt und übergeben. Das XML Dokument würde folgendermaßen aussehen:

< Container>Inhalt</ Container >

Wer mit der XML Sytax vertraut ist, wird jetzt feststellen, daß hier die XML Deklaration fehlt, damit ein valides XML Dokument entsteht. Der folgende Code zeigt, wie diese Deklaration erstellt wird:

var Adressen = new XDocument( 
    new XDeclaration("1.0", "utf-8", "yes"), 
    new XElement("Container", "Inhalt") 
    ); 

Nun sieht die Ausgabe wie folgt aus:

<?xml version="1.0" encoding="utf-8" standalone="yes"?> 
<Container>Inhalt</Container> 

Der Konstruktor der Klasse XElement kann beliebig viele andere Objekte aufnehmen so wird es sehr einfach, mehrere Objekte zu verschachteln wie das Beispiel zeigt:

var Adressen = new XDocument( 
    new XDeclaration("1.0", "UTF-16", "yes"), 
    new XComment("Kommentar"), 
    new XElement("Adressen", 
                 new XElement("Adresse", 
                              new XElement("Name", "Paul Faul"), 
                              new XElement("Telefon", "000"), 
                              new XElement("Anschrift", 
                                           new XElement("Straße", "Musterstraße 1"), 
                                           new XElement("Stadt", "Musterstadt"), 
                                           new XElement("Postleitzahl", "99999") 
                                  ) 
                     ) 
        ) 
    );

Um das erstellte XML Dokument abzuspeichern, bietet die Klasse XDocument die Methode Save an:

Adressen.Save("D:\\test.xml"); 

Einfacher geht es kaum.

Im Anhang befindet sich ein kleines Beispielprojekt zum Ausprobieren.
Im nächsten Teil geht es um die Abfrage von XML Dateien.

Download Beispielprojekt