2007-10-19

XObject

Die XObject-Klasse ist die Basis-Klasse für die meisten LINQ to XML API Klassen. Die XNode und XAttribut Klassen vererben diese und können dadurch die Methoden der XObject-Klasse verwenden.

Mit der AddAnnotation()-Methode der XObject-Klasse kann eine selbst definierte Information (Anmerkung) an einem XElement-Objekt hinzugefügt und mit der RemoveAnnotation()-Methode entfernt werden. Die Ermittlung der hinzugefügten Anmerkung erfolgt über die Annotation()-Methode.

Beispiel
Wir fügen an das planet Element die jetzige Datum und Zeit als eine selbstdefinierte Anmerkung hinzu.

Als Resultat erwarten wir die hinzugefügte Anmerkung bzw. die Zeit-Information.

Datenquelle
Als Datenquelle verwenden wir ein neu erstelltes XElement-Objekt, welches den Planet Merkur als Information beinhaltet.

XElement planet = new XElement("Planet",
new XAttribute("Id", "1"),
new XAttribute("Name", "Merkur"));
Methodenaufruf
planet.AddAnnotation(DateTime.Now);


Auswertung
Object annotation = planet.Annotation(typeof(DateTime));

Resultat
Als Resultat erhalten wir die Anmerkung in der Variablen annotation in der das Datum und die Zeit enthalten sind.

No comments: