Création d'arborescences XML en C# (LINQ to XML)
Cette section fournit des informations sur la création d'arborescences XML en C#.
Pour plus d'informations sur l'utilisation des résultats de requêtes LINQ comme contenu d'un objet XElement, consultez Construction fonctionnelle (LINQ to XML).
Construction d'éléments
Les signatures des constructeurs XElement et XAttribute vous permettent de passer le contenu de l'élément ou attribut en tant qu'arguments du constructeur. Étant donné que l'un des constructeurs prend une quantité variable d'arguments, vous pouvez passer une quantité quelconque d'éléments enfants. Bien entendu, chacun de ces éléments enfants peut contenir ses propres éléments enfants. Pour tout élément, vous pouvez ajouter une quantité quelconque d'attributs.
Lors de l'ajout d'objets XNode (y compris XElement) ou XAttribute, si le contenu n'a pas de parent, les objets sont simplement attachés à l'arborescence XML. Si le nouveau contenu a déjà un parent et fait partie d'une autre arborescence XML, il est cloné et le nouveau contenu cloné est attaché à l'arborescence XML. Ceci est illustré dans le dernier exemple de cette rubrique.
Pour créer un objet contacts XElement, vous pouvez utiliser le code suivant :
XElement contacts =
new XElement("Contacts",
new XElement("Contact",
new XElement("Name", "Patrick Hines"),
new XElement("Phone", "206-555-0144"),
new XElement("Address",
new XElement("Street1", "123 Main St"),
new XElement("City", "Mercer Island"),
new XElement("State", "WA"),
new XElement("Postal", "68042")
)
)
);
S'il est mis en retrait correctement, le code pour construire des objets XElement ressemble étroitement à la structure du code XML sous-jacent.
Visual Basic propose une autre approche pour la création d'arborescences XML : vous pouvez incorporer du code XML directement dans votre programme Visual Basic en tant que littéral XML. Pour plus d'informations, consultez Introduction au littéraux XML en Visual Basic.
Constructeurs XElement
La classe XElement utilise les constructeurs suivants pour la construction fonctionnelle. Notez qu'il existe d'autres constructeurs pour XElement, mais ils ne sont pas répertoriés ici car ils ne sont pas utilisés pour la construction fonctionnelle.
Constructeur |
Description |
|---|---|
XElement(XName name, object content) |
Crée un objet XElement. Le paramètre name spécifie le nom de l'élément ; content spécifie le contenu de l'élément. |
XElement(XName name) |
Crée un objet XElement avec son objet XName initialisé au nom spécifié. |
XElement(XName name, params object[] content) |
Crée un objet XElement avec son objet XName initialisé au nom spécifié. Les attributs et/ou éléments enfants sont créés à partir du contenu de la liste de paramètres. |
Le paramètre content est extrêmement souple. Il prend en charge tout type d'objet qui est un enfant valide d'un objet XElement. Les règles suivantes s'appliquent à différents types d'objets passés dans ce paramètre :
Une chaîne est ajoutée en tant que contenu de texte.
Un objet XElement est ajouté en tant qu'élément enfant.
Un objet XAttribute est ajouté en tant qu'attribut.
Un objet XProcessingInstruction, XComment ou XText est ajouté en tant que contenu enfant.
Un objet IEnumerable est énuméré et ces règles sont appliquées de manière récursive aux résultats.
Pour tout autre type, sa méthode ToString est appelée et le résultat est ajouté en tant que contenu texte.
Création d'un XElement avec du contenu
Vous pouvez créer un objet XElement qui contient du contenu simple avec un appel de méthode unique. Pour cela, spécifiez le contenu comme second paramètre, comme suit :
XElement n = new XElement("Customer", "Adventure Works");
Console.WriteLine(n);
Cet exemple génère la sortie suivante :
<Customer>Adventure Works</Customer>
Vous pouvez passer tout type d'objet en tant que contenu. Par exemple, le code suivant crée un élément qui contient un nombre à virgule flottante en tant que contenu :
XElement n = new XElement("Cost", 324.50);
Console.WriteLine(n);
Cet exemple génère la sortie suivante :
<Cost>324.5</Cost>
Le nombre à virgule flottante est boxed et passé au constructeur. Le nombre boxed est converti en une chaîne et utilisé comme contenu de l'élément.
Création d'un XElement avec un élément enfant
Si vous passez une instance de la classe XElement comme argument de contenu, le constructeur crée un élément avec un élément enfant :
XElement shippingUnit = new XElement("ShippingUnit",
new XElement("Cost", 324.50)
);
Console.WriteLine(shippingUnit);
Cet exemple génère la sortie suivante :
<ShippingUnit>
<Cost>324.5</Cost>
</ShippingUnit>
Création d'un XElement avec plusieurs éléments enfants
Vous pouvez passer une quantité quelconque d'objets XElement comme contenu. Chacun des objets XElement est inclus en tant qu'élément enfant.
XElement address = new XElement("Address",
new XElement("Street1", "123 Main St"),
new XElement("City", "Mercer Island"),
new XElement("State", "WA"),
new XElement("Postal", "68042")
);
Console.WriteLine(address);
Cet exemple génère la sortie suivante :
<Address>
<Street1>123 Main St</Street1>
<City>Mercer Island</City>
<State>WA</State>
<Postal>68042</Postal>
</Address>
En étendant l'exemple ci-dessus, vous pouvez créer une arborescence XML entière, comme suit :
XElement contacts =
new XElement("Contacts",
new XElement("Contact",
new XElement("Name", "Patrick Hines"),
new XElement("Phone", "206-555-0144"),
new XElement("Address",
new XElement("Street1", "123 Main St"),
new XElement("City", "Mercer Island"),
new XElement("State", "WA"),
new XElement("Postal", "68042")
)
)
);
Console.WriteLine(contacts);
Cet exemple génère la sortie suivante :
<Contacts>
<Contact>
<Name>Patrick Hines</Name>
<Phone>206-555-0144</Phone>
<Address>
<Street1>123 Main St</Street1>
<City>Mercer Island</City>
<State>WA</State>
<Postal>68042</Postal>
</Address>
</Contact>
</Contacts>
Création d'un élément vide
Pour créer un objet XElement vide, vous ne passez aucun contenu au constructeur. L'exemple suivant crée un élément vide :
XElement n = new XElement("Customer");
Console.WriteLine(n);
Cet exemple génère la sortie suivante :
<Customer />
attachement etclonage
Comme mentionné précédemment, lors de l'ajout d'objets XNode (y compris XElement) ou XAttribute, si le contenu n'a pas de parent, les objets sont simplement attachés à l'arborescence XML. Si le nouveau contenu a déjà un parent et fait partie d'une autre arborescence XML, il est cloné et le nouveau contenu cloné est attaché à l'arborescence XML.
// Create a tree with a child element.
XElement xmlTree1 = new XElement("Root",
new XElement("Child1", 1)
);
// Create an element that is not parented.
XElement child2 = new XElement("Child2", 2);
// Create a tree and add Child1 and Child2 to it.
XElement xmlTree2 = new XElement("Root",
xmlTree1.Element("Child1"),
child2
);
// Compare Child1 identity.
Console.WriteLine("Child1 was {0}",
xmlTree1.Element("Child1") == xmlTree2.Element("Child1") ?
"attached" : "cloned");
// Compare Child2 identity.
Console.WriteLine("Child2 was {0}",
child2 == xmlTree2.Element("Child2") ?
"attached" : "cloned");
Cet exemple génère la sortie suivante :
Child1 was cloned
Child2 was attached