XDocument Classe

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

XDocument.cs

Représente un document XML. Pour les composants et l’utilisation d’un objet XDocument, consultez Vue d’ensemble de la classe XDocument.

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

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

Héritage

Object

XObject

XNode

XContainer

XDocument

Exemples

L’exemple suivant crée un document, puis y ajoute un commentaire et un élément. Il compose ensuite un autre document à l’aide des résultats d’une requête.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

Cet exemple produit la sortie suivante :

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Remarques

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

Constructeurs

XDocument()	Initialise une nouvelle instance de la classe XDocument.
XDocument(Object[])	Initialise une nouvelle instance de la classe XDocument avec le contenu spécifié.
XDocument(XDeclaration, Object[])	Initialise une nouvelle instance de la classe XDocument avec la XDeclaration et le contenu spécifiés.
XDocument(XDocument)	Initialise une nouvelle instance de la classe XDocument à partir d'un objet XDocument existant.

Propriétés

BaseUri	Obtient l'URI de base pour ce XObject. (Hérité de XObject)
Declaration	Obtient ou définit la déclaration XML pour ce document.
Document	Obtient le XDocument pour ce XObject. (Hérité de XObject)
DocumentType	Obtient la définition de type de document (DTD) pour ce document.
FirstNode	Obtient le premier nœud enfant de ce nœud. (Hérité de XContainer)
LastNode	Obtient le dernier nœud enfant de ce nœud. (Hérité de XContainer)
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)
Root	Obtient l'élément racine de l'arborescence XML pour ce document.

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)
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)
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)
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)
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)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
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 XDocument à l'aide du flux spécifié.
Load(Stream, LoadOptions)	Crée une instance XDocument à 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)	Crée un XDocument à partir d'un fichier.
Load(String, LoadOptions)	Crée un XDocument à 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)	Crée XDocument à partir d'un TextReader.
Load(TextReader, LoadOptions)	Crée un XDocument à partir d'un TextReader, en conservant éventuellement l'espace blanc, en définissant l'URI de base, et en conservant les informations de ligne.
Load(XmlReader)	Crée un XDocument à partir d'un XmlReader.
Load(XmlReader, LoadOptions)	Charge un XDocument à partir d'un XmlReader, en définissant éventuellement l'URI de base, et en conservant les informations de ligne.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crée de façon asynchrone un nouveau XDocument et initialise son arborescence XML sous-jacente à partir du flux spécifié, en conservant éventuellement l’espace blanc.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crée un nouveau XDocument et initialise son arborescence XML sous-jacente à l'aide du paramètre TextReader spécifié, en conservant éventuellement l’espace blanc.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crée un nouveau XDocument contenant le contenu du XmlReader spécifié.
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)	Crée un XDocument à partir d'une chaîne.
Parse(String, LoadOptions)	Crée un XDocument à partir d'une chaîne, en conservant éventuellement l'espace blanc, en définissant l'URI de base, et en conservant les informations de ligne.
Remove()	Supprime ce nœud de son parent. (Hérité de XNode)
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)
RemoveNodes()	Supprime les nœuds enfants de ce document ou de cet élément. (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)
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 XDocument vers le Stream spécifié.
Save(Stream, SaveOptions)	Génère ce XDocument vers le Stream spécifié, en précisant le cas échéant le comportement de mise en forme.
Save(String)	Sérialise ce XDocument dans un fichier, en remplaçant un fichier existant, le cas échéant.
Save(String, SaveOptions)	Sérialise ce XDocument vers un fichier, en désactivant éventuellement la mise en forme.
Save(TextWriter)	Sérialise ce XDocument vers un TextWriter.
Save(TextWriter, SaveOptions)	Sérialise ce XDocument vers un TextWriter, en désactivant éventuellement la mise en forme.
Save(XmlWriter)	Sérialise ce XDocument vers un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Envoyer ce XDocument à un Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Écrit ce XDocument dans un TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Écrit ce XDocument dans un XmlWriter.
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 ce document vers un XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Écrit l’arborescence XML sous-jacente de ce XDocument dans le XmlWriter spécifié.

É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)

Méthodes d’extension

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Cette méthode valide le fait qu'un XDocument est conforme à un XSD dans un XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Valide le fait qu'un XDocument est conforme à un XSD dans 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

• XNamespace
• XDeclaration
• XElement
• XNode
• Vue d’ensemble de LINQ to XML
• Vue d’ensemble de la classe XDocument