XElement Classe

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Représente un élément XML. Pour des informations d’utilisation et des exemples, consultez Vue d’ensemble de la classe XElement et la section Notes de cette page.

public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable

public ref class XElement : System::Xml::Linq::XContainer

public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable

public class XElement : System.Xml.Linq.XContainer

type XElement = class
    inherit XContainer
    interface IXmlSerializable

type XElement = class
    inherit XContainer

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

Public Class XElement
Inherits XContainer

Héritage

Object

XObject

XNode

XContainer

XElement

Implémente

IXmlSerializable

Exemples

L’exemple suivant crée une arborescence XML. Le contenu du nouvel élément provient d’une requête LINQ.

XElement xmlTree1 = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5),  
    new XElement("Child6", 6)  
);  

XElement xmlTree2 = new XElement("Root",  
    from el in xmlTree1.Elements()  
    where((int)el >= 3 && (int)el <= 5)  
    select el  
);  
Console.WriteLine(xmlTree2);  

Dim xmlTree1 As XElement = _  
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
            <Child6>6</Child6>  
        </Root>  

Dim xmlTree2 As XElement = _   
    <Root>  
        <%= From el In xmlTree1.Elements() _  
            Where el.Value >= 3 And el.Value <= 5 _  
            Select el %>  
    </Root>  

Console.WriteLine(xmlTree2)  

Cet exemple produit la sortie suivante :

<Root>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

Voici le même exemple, mais dans ce cas, le xml se trouve dans un espace de noms. Pour plus d’informations, consultez Utiliser des espaces de noms XML.

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree1 = new XElement(aw + "Root",  
    new XElement(aw + "Child1", 1),  
    new XElement(aw + "Child2", 2),  
    new XElement(aw + "Child3", 3),  
    new XElement(aw + "Child4", 4),  
    new XElement(aw + "Child5", 5),  
    new XElement(aw + "Child6", 6)  
);  

XElement xmlTree2 = new XElement(aw + "Root",  
    from el in xmlTree1.Elements()  
    where((int)el >= 3 && (int)el <= 5)  
    select el  
);  
Console.WriteLine(xmlTree2);  

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

Module Module1  
    Sub Main()  
        Dim xmlTree1 As XElement = _  
            <Root>  
                <Child1>1</Child1>  
                <Child2>2</Child2>  
                <Child3>3</Child3>  
                <Child4>4</Child4>  
                <Child5>5</Child5>  
                <Child6>6</Child6>  
            </Root>  

        Dim xmlTree2 As XElement = _   
            <Root>  
                <%= From el In xmlTree1.Elements() _  
                    Where el.Value >= 3 And el.Value <= 5 _  
                    Select el %>  
            </Root>  

        Console.WriteLine(xmlTree2)  
    End SUb  
End Module  

Cet exemple produit la sortie suivante :

<Root xmlns="http://www.adventure-works.com">  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

Remarques

Cette classe représente un élément XML, la construction XML fondamentale. Consultez la vue d’ensemble de la classe XElement pour obtenir d’autres informations d’utilisation.

Un élément possède un XNameou plusieurs attributs , éventuellement un ou plusieurs attributs et peut éventuellement contenir du contenu (pour plus d’informations, voir Nodes).

Un XElement peut contenir les types de contenu suivants :

• XElement

• XComment

• XProcessingInstruction

• XText

Pour plus d’informations sur le contenu valide d’un XElementobjet , consultez Contenu valide des objets XElement et XDocument.

XElement dérive de XContainer, qui dérive de XNode.

Certaines XElement méthodes peuvent être utilisées à partir de XAML. Pour plus d’informations, consultez Propriétés dynamiques LINQ to XML.

Constructeurs

XElement(XElement)	Initialise une nouvelle instance de la classe XElement à partir d'un autre objet XElement.
XElement(XName)	Initialise une nouvelle instance de la classe XElement avec le nom spécifié.
XElement(XName, Object)	Initialise une nouvelle instance de la classe XElement avec le nom et le contenu spécifiés.
XElement(XName, Object[])	Initialise une nouvelle instance de la classe XElement avec le nom et le contenu spécifiés.
XElement(XStreamingElement)	Initialise une nouvelle instance de la classe XElement à partir d'un objet XStreamingElement.

Propriétés

BaseUri	Obtient l'URI de base pour ce XObject. (Hérité de XObject)
Document	Obtient le XDocument pour ce XObject. (Hérité de XObject)
EmptySequence	Obtient une collection d’éléments vide.
FirstAttribute	Obtient le premier attribut de cet élément.
FirstNode	Obtient le premier nœud enfant de ce nœud. (Hérité de XContainer)
HasAttributes	Obtient une valeur indiquant si cet élément possède au moins un attribut.
HasElements	Obtient une valeur indiquant si cet élément possède au moins un élément enfant.
IsEmpty	Obtient une valeur indiquant si cet élément ne contient aucun contenu.
LastAttribute	Obtient le dernier attribut de cet élément.
LastNode	Obtient le dernier nœud enfant de ce nœud. (Hérité de XContainer)
Name	Obtient ou définit le nom de cet élément.
NextNode	Obtient le nœud frère suivant de ce nœud. (Hérité de XNode)
NodeType	Obtient le type de ce nœud.
Parent	Obtient le XElement parent de ce XObject. (Hérité de XObject)
PreviousNode	Obtient le nœud frère précédent de ce nœud. (Hérité de XNode)
Value	Obtient ou définit le texte concaténé de cet élément.

Méthodes

Add(Object)	Ajoute le contenu spécifié en tant qu'enfants de ce XContainer. (Hérité de XContainer)
Add(Object[])	Ajoute le contenu spécifié en tant qu'enfants de ce XContainer. (Hérité de XContainer)
AddAfterSelf(Object)	Ajoute le contenu spécifié immédiatement après ce nœud. (Hérité de XNode)
AddAfterSelf(Object[])	Ajoute le contenu spécifié immédiatement après ce nœud. (Hérité de XNode)
AddAnnotation(Object)	Ajoute un objet à la liste d'annotations de ce XObject. (Hérité de XObject)
AddBeforeSelf(Object)	Ajoute le contenu spécifié immédiatement avant ce nœud. (Hérité de XNode)
AddBeforeSelf(Object[])	Ajoute le contenu spécifié immédiatement avant ce nœud. (Hérité de XNode)
AddFirst(Object)	Ajoute le contenu spécifié en tant que premiers enfants de ce document ou élément. (Hérité de XContainer)
AddFirst(Object[])	Ajoute le contenu spécifié en tant que premiers enfants de ce document ou élément. (Hérité de XContainer)
Ancestors()	Retourne une collection des éléments ancêtres de ce nœud. (Hérité de XNode)
Ancestors(XName)	Retourne une collection filtrée des éléments ancêtres de ce nœud. Seuls les éléments avec un XName correspondant sont inclus dans la collection. (Hérité de XNode)
AncestorsAndSelf()	Retourne une collection d'éléments contenant cet élément ainsi que ses ancêtres.
AncestorsAndSelf(XName)	Retourne une collection filtrée d'éléments contenant cet élément ainsi que ses ancêtres. Seuls les éléments avec un XName correspondant sont inclus dans la collection.
Annotation(Type)	Obtient le premier objet d'annotation du type spécifié à partir de ce XObject. (Hérité de XObject)
Annotation<T>()	Obtient le premier objet d'annotation du type spécifié à partir de ce XObject. (Hérité de XObject)
Annotations(Type)	Obtient une collection d'annotations du type spécifié pour ce XObject. (Hérité de XObject)
Annotations<T>()	Obtient une collection d'annotations du type spécifié pour ce XObject. (Hérité de XObject)
Attribute(XName)	Retourne le XAttribute de ce XElement qui a le XName spécifié.
Attributes()	Retourne une collection d'attributs de cet élément.
Attributes(XName)	Retourne une collection filtrée d’attributs de cet élément. Seuls les attributs auxquels correspond un XName sont inclus dans la collection.
CreateReader()	Crée un XmlReader pour ce nœud. (Hérité de XNode)
CreateReader(ReaderOptions)	Crée un XmlReader avec les options spécifiées par le paramètre readerOptions. (Hérité de XNode)
CreateWriter()	Crée un XmlWriter qui peut être utilisé pour ajouter des nœuds au XContainer. (Hérité de XContainer)
DescendantNodes()	Retourne une collection des nœuds descendants pour ce document ou cet élément, dans l'ordre des documents. (Hérité de XContainer)
DescendantNodesAndSelf()	Retourne une collection de nœuds contenant cet élément ainsi que tous ses nœuds descendants, dans l’ordre du document.
Descendants()	Retourne une collection des éléments descendants pour ce document ou cet élément, dans l'ordre des documents. (Hérité de XContainer)
Descendants(XName)	Retourne une collection filtrée des éléments descendants pour ce document ou cet élément, dans l'ordre des documents. Seuls les éléments avec un XName correspondant sont inclus dans la collection. (Hérité de XContainer)
DescendantsAndSelf()	Retourne une collection d’éléments contenant cet élément ainsi que tous ses éléments descendants, dans l’ordre du document.
DescendantsAndSelf(XName)	Retourne une collection filtrée d’éléments contenant cet élément ainsi que tous ses éléments descendants, dans l’ordre du document. Seuls les éléments avec un XName correspondant sont inclus dans la collection.
Element(XName)	Obtient le premier (dans l'ordre des documents) élément enfant avec le XName spécifié. (Hérité de XContainer)
Elements()	Retourne une collection des éléments enfants de cet élément ou de ce document, dans l'ordre des documents. (Hérité de XContainer)
Elements(XName)	Retourne une collection filtrée des éléments enfants de cet élément ou de ce document, dans l'ordre des documents. Seuls les éléments avec un XName correspondant sont inclus dans la collection. (Hérité de XContainer)
ElementsAfterSelf()	Retourne une collection des éléments frères après ce nœud, dans l'ordre du document. (Hérité de XNode)
ElementsAfterSelf(XName)	Retourne une collection filtrée des éléments frères après ce nœud, dans l’ordre du document. Seuls les éléments avec un XName correspondant sont inclus dans la collection. (Hérité de XNode)
ElementsBeforeSelf()	Retourne une collection des éléments frères avant ce nœud, dans l’ordre du document. (Hérité de XNode)
ElementsBeforeSelf(XName)	Retourne une collection filtrée des éléments frères avant ce nœud, dans l’ordre du document. Seuls les éléments avec un XName correspondant sont inclus dans la collection. (Hérité de XNode)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDefaultNamespace()	Obtient le XNamespace par défaut de ce XElement.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetNamespaceOfPrefix(String)	Obtient l'espace de noms associé à un préfixe particulier pour ce XElement.
GetPrefixOfNamespace(XNamespace)	Obtient le préfixe associé à un espace de noms pour ce XElement.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsAfter(XNode)	Détermine si le nœud actuel apparaît après un nœud spécifié dans l'ordre du document. (Hérité de XNode)
IsBefore(XNode)	Détermine si le nœud actuel apparaît avant un nœud spécifié dans l'ordre du document. (Hérité de XNode)
Load(Stream)	Crée une nouvelle instance de XElement à l'aide du flux spécifié.
Load(Stream, LoadOptions)	Crée une instance XElement à partir du flux spécifié, en conservant éventuellement l'espace blanc, en définissant l'URI de base, et en conservant les informations de ligne.
Load(String)	Charge un XElement à partir d'un fichier.
Load(String, LoadOptions)	Charge un XElement à partir d'un fichier, en conservant éventuellement l'espace blanc, en définissant l'URI de base, et en conservant les informations de ligne.
Load(TextReader)	Charge un XElement à partir d'un TextReader.
Load(TextReader, LoadOptions)	Charge un XElement à partir d'un TextReader, en conservant éventuellement l'espace blanc et les informations de ligne.
Load(XmlReader)	Charge un XElement à partir d'un XmlReader.
Load(XmlReader, LoadOptions)	Charge un XElement à partir d'un XmlReader, en conservant éventuellement l'espace blanc, en définissant l'URI de base, et en conservant les informations de ligne.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crée de façon asynchrone un nouveau XElement et initialise son arborescence XML sous-jacente à partir du flux spécifié, en conservant éventuellement l’espace blanc.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crée de façon asynchrone un nouveau XElement et initialise son arborescence XML sous-jacente à partir du lecteur de texte spécifié, en conservant éventuellement l’espace blanc.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crée de façon asynchrone un nouveau XElement et initialise son arborescence XML sous-jacente à partir du lecteur XML spécifié, en conservant éventuellement l’espace blanc.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Nodes()	Retourne une collection des nœuds enfants de cet élément ou de ce document, dans l'ordre des documents. (Hérité de XContainer)
NodesAfterSelf()	Retourne une collection des nœuds frères après ce nœud, dans l’ordre du document. (Hérité de XNode)
NodesBeforeSelf()	Retourne une collection des nœuds frères avant ce nœud, dans l’ordre du document. (Hérité de XNode)
Parse(String)	Chargez un XElement à partir d'une chaîne qui contient le code XML.
Parse(String, LoadOptions)	Chargez un XElement à partir d'une chaîne qui contient du code XML, en conservant éventuellement les espaces blancs et les informations de ligne.
Remove()	Supprime ce nœud de son parent. (Hérité de XNode)
RemoveAll()	Supprime des nœuds et des attributs de ce XElement.
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de ce XObject. (Hérité de XObject)
RemoveAnnotations<T>()	Supprime les annotations du type spécifié de ce XObject. (Hérité de XObject)
RemoveAttributes()	Supprime les attributs de ce XElement.
RemoveNodes()	Supprime les nœuds enfants de ce document ou de cet élément. (Hérité de XContainer)
ReplaceAll(Object)	Remplace les nœuds enfants et les attributs de cet élément par le contenu spécifié.
ReplaceAll(Object[])	Remplace les nœuds enfants et les attributs de cet élément par le contenu spécifié.
ReplaceAttributes(Object)	Remplace les attributs de cet élément par le contenu spécifié.
ReplaceAttributes(Object[])	Remplace les attributs de cet élément par le contenu spécifié.
ReplaceNodes(Object)	Remplace les nœuds enfants de ce document ou de cet élément par le contenu spécifié. (Hérité de XContainer)
ReplaceNodes(Object[])	Remplace les nœuds enfants de ce document ou de cet élément par le contenu spécifié. (Hérité de XContainer)
ReplaceWith(Object)	Remplace ce nœud par le contenu spécifié. (Hérité de XNode)
ReplaceWith(Object[])	Remplace ce nœud par le contenu spécifié. (Hérité de XNode)
Save(Stream)	Renvoie ce XElement vers le Stream spécifié.
Save(Stream, SaveOptions)	Génère ce XElement vers le Stream spécifié, en précisant le cas échéant le comportement de mise en forme.
Save(String)	Sérialisez cet élément dans un fichier.
Save(String, SaveOptions)	Sérialisez cet élément dans un fichier, en désactivant éventuellement la mise en forme.
Save(TextWriter)	Sérialisez cet élément vers un TextWriter.
Save(TextWriter, SaveOptions)	Sérialisez cet élément vers un TextWriter, en désactivant éventuellement la mise en forme.
Save(XmlWriter)	Sérialisez cet élément vers un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Exporte de façon asynchrone ce XElement vers un Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Exporte de façon asynchrone ce XElement vers un TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Exporte de façon asynchrone ce XElement vers un XmlWriter.
SetAttributeValue(XName, Object)	Définit la valeur d'un attribut, ajoute un attribut ou supprime un attribut.
SetElementValue(XName, Object)	Définit la valeur d'un élément enfant, ajoute un élément enfant ou supprime un élément enfant.
SetValue(Object)	Définit la valeur de cet élément.
ToString()	Retourne le code XML mis en retrait pour ce nœud. (Hérité de XNode)
ToString(SaveOptions)	Retourne le code XML pour ce nœud, en désactivant éventuellement la mise en forme. (Hérité de XNode)
WriteTo(XmlWriter)	Écrivez cet élément vers un XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Écrit de façon asynchrone ce XElement sur l’enregistreur spécifié.
WriteToAsync(XmlWriter, CancellationToken)	Écrit le nœud actuel dans un XmlWriter. (Hérité de XNode)

Opérateurs

Explicit(XElement to Boolean)	Castez la valeur de ce XElement en Boolean.
Explicit(XElement to DateTime)	Castez la valeur de ce XElement en DateTime.
Explicit(XElement to DateTimeOffset)	Castez la valeur de ce XAttribute en DateTimeOffset.
Explicit(XElement to Decimal)	Castez la valeur de ce XElement en Decimal.
Explicit(XElement to Double)	Castez la valeur de ce XElement en Double.
Explicit(XElement to Guid)	Castez la valeur de ce XElement en Guid.
Explicit(XElement to Int32)	Castez la valeur de ce XElement en Int32.
Explicit(XElement to Int64)	Castez la valeur de ce XElement en Int64.
Explicit(XElement to Nullable<Boolean>)	Castez la valeur de ce XElement en Nullable<T> de Boolean.
Explicit(XElement to Nullable<DateTime>)	Castez la valeur de ce XElement en Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Castez la valeur de ce XElement en Nullable<T> de DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)	Castez la valeur de ce XElement en Nullable<T> de Decimal.
Explicit(XElement to Nullable<Double>)	Castez la valeur de ce XElement en Nullable<T> de Double.
Explicit(XElement to Nullable<Guid>)	Castez la valeur de ce XElement en Nullable<T> de Guid.
Explicit(XElement to Nullable<Int32>)	Castez la valeur de ce XElement en Nullable<T> de Int32.
Explicit(XElement to Nullable<Int64>)	Castez la valeur de ce XElement en Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)	Castez la valeur de ce XElement en Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)	Castez la valeur de ce XElement en Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Castez la valeur de ce XElement en Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)	Castez la valeur de ce XElement en Nullable<T> de UInt64.
Explicit(XElement to Single)	Castez la valeur de ce XElement en Single.
Explicit(XElement to String)	Castez la valeur de ce XElement en String.
Explicit(XElement to TimeSpan)	Castez la valeur de ce XElement en TimeSpan.
Explicit(XElement to UInt32)	Castez la valeur de ce XElement en UInt32.
Explicit(XElement to UInt64)	Castez la valeur de ce XElement en UInt64.

Événements

Changed	Déclenché lorsque ce XObject ou l'un de ses descendants change. (Hérité de XObject)
Changing	Déclenché lorsque ce XObject ou l'un de ses descendants est sur le point de changer. (Hérité de XObject)

Implémentations d’interfaces explicites

IXmlLineInfo.HasLineInfo()	Obtient une valeur indiquant si ce XObject a des informations de ligne. (Hérité de XObject)
IXmlLineInfo.LineNumber	Obtient le numéro de ligne que le XmlReader sous-jacent a rapporté pour ce XObject. (Hérité de XObject)
IXmlLineInfo.LinePosition	Obtient la position de ligne que le XmlReader sous-jacent a rapportée pour ce XObject. (Hérité de XObject)
IXmlSerializable.GetSchema()	Obtient une définition de schéma XML qui décrit la représentation XML de cet objet.
IXmlSerializable.ReadXml(XmlReader)	Génère un objet à partir de sa représentation XML.
IXmlSerializable.WriteXml(XmlWriter)	Convertit un objet en sa représentation XML.

Méthodes d’extension

GetSchemaInfo(XElement)	Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un élément validé.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	Cette méthode valide le fait qu'une sous-arborescence XElement est conforme à un XmlSchemaObject spécifié et un XmlSchemaSet.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	Valide le fait qu'une sous-arborescence XElement est conforme à un XmlSchemaObject spécifié et un XmlSchemaSet, en remplissant en option l'arborescence XML à l'aide du jeu d'informations postérieures à la validation du schéma (jeu PSVI).
CreateNavigator(XNode)	Crée un XPathNavigator pour un XNode.
CreateNavigator(XNode, XmlNameTable)	Crée un XPathNavigator pour un XNode. Le XmlNameTable permet un traitement d'expression XPath plus efficace.
XPathEvaluate(XNode, String)	Évalue une expression XPath.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Évalue une expression XPath, en résolvant les préfixes d'espace de noms à l'aide du IXmlNamespaceResolver spécifié.
XPathSelectElement(XNode, String)	Sélectionne un XElement à l'aide d'une expression XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Sélectionne un XElement à l'aide d'une expression XPath, en résolvant les préfixes d'espace de noms à l'aide du IXmlNamespaceResolver spécifié.
XPathSelectElements(XNode, String)	Sélectionne une collection d'éléments à l'aide d'une expression XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Sélectionne une collection d'éléments à l'aide d'une expression XPath, en résolvant les préfixes d'espace de noms à l'aide du IXmlNamespaceResolver spécifié.
ToXPathNavigable(XNode)	Retourne un accesseur qui vous permet de parcourir et de modifier le XNode spécifié.

Voir aussi

• Vue d’ensemble de LINQ to XML
• Propriétés dynamiques LINQ to XML