XDocument Classe

Définition

Espace de noms:
System.Xml.Linq
Assemblys:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblys:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Source:
XDocument.cs
Source:
XDocument.cs
Source:
XDocument.cs
Source:
XDocument.cs
Source:
XDocument.cs

Représente un document XML. Pour connaître les composants et l’utilisation d’un XDocument objet, 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 ajoute un commentaire et un élément à celui-ci. 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 XDocumentobjet , consultez Contenu valide des objets XElement et XDocument.

Constructeurs

Nom Description
XDocument()

Initialise une nouvelle instance de la classe XDocument.
XDocument(Object[])

Initialise une nouvelle instance de la XDocument classe avec le contenu spécifié.
XDocument(XDeclaration, Object[])

Initialise une nouvelle instance de la XDocument classe avec le contenu et le contenu spécifiés XDeclaration .
XDocument(XDocument)

Initialise une nouvelle instance de la XDocument classe à partir d’un objet existant XDocument .

Propriétés

Nom Description
BaseUri

Obtient l’URI de base de ce XObject.

(Hérité de XObject)
Declaration

Obtient ou définit la déclaration XML pour ce document.
Document

Obtient la XDocument valeur de 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 nœud pour ce nœud.
Parent

Obtient le parent XElement 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

Nom Description
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 qui ont 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 nœud pour ce nœud.

(Hérité de XNode)
CreateReader(ReaderOptions)

Crée une XmlReader avec les options spécifiées par le readerOptions paramètre.

(Hérité de XNode)
CreateWriter()

Crée un XmlWriter élément 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 du document. Seuls les éléments qui ont un XName correspondant sont inclus dans la collection.

(Hérité de XContainer)
Element(XName)

Obtient le premier élément enfant (dans l’ordre du document) avec le fichier spécifié XName.

(Hérité de XContainer)
Elements()

Retourne une collection des éléments enfants de cet élément ou document, dans l’ordre du document.

(Hérité de XContainer)
Elements(XName)

Retourne une collection filtrée des éléments enfants de cet élément ou document, dans l’ordre du document. Seuls les éléments qui ont 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 qui ont 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 des documents.

(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 qui ont 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()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la 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é en termes d’ordre de document.

(Hérité de XNode)
IsBefore(XNode)

Détermine si le nœud actuel apparaît avant un nœud spécifié en termes d’ordre de document.

(Hérité de XNode)
Load(Stream, LoadOptions)

Crée une XDocument instance à l’aide 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(Stream)

Crée une XDocument instance à l’aide du flux spécifié.
Load(String, LoadOptions)

Crée un nouveau XDocument fichier, 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 nouveau fichier à partir d’un fichier.
Load(TextReader, LoadOptions)

Crée une nouveauté XDocument à partir d’un TextReaderespace blanc , en conservant éventuellement l’espace blanc, en définissant l’URI de base et en conservant les informations de ligne.
Load(TextReader)

Crée un nouveau XDocument à partir d’un TextReader.
Load(XmlReader, LoadOptions)

Charge un élément à XDocument partir d’un XmlReaderURI de base, et conserve les informations de ligne.
Load(XmlReader)

Crée un nouveau XDocument à partir d’un XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)

Crée de façon asynchrone une XDocument arborescence XML sous-jacente à partir du flux spécifié et initialise éventuellement l’espace blanc.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Crée une XDocument arborescence XML sous-jacente et initialise son arborescence XML sous-jacente à l’aide du paramètre spécifié TextReader , en conservant éventuellement l’espace blanc.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crée un XDocument nouveau contenu contenant le contenu de l’objet spécifié XmlReader.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Nodes()

Retourne une collection des nœuds enfants de cet élément ou document, dans l’ordre du document.

(Hérité de XContainer)
NodesAfterSelf()

Retourne une collection des nœuds frères après ce nœud, dans l’ordre des documents.

(Hérité de XNode)
NodesBeforeSelf()

Retourne une collection des nœuds frères avant ce nœud, dans l’ordre des documents.

(Hérité de XNode)
Parse(String, LoadOptions)

Crée une nouvelle XDocument chaîne, en conservant éventuellement des espaces blancs, en définissant l’URI de base et en conservant les informations de ligne.
Parse(String)

Crée une nouvelle XDocument à partir d’une chaîne.
Remove()

Supprime ce nœud de son parent.

(Hérité de XNode)
RemoveAnnotations(Type)

Supprime les annotations du type spécifié de ce XObjecttype .

(Hérité de XObject)
RemoveAnnotations<T>()

Supprime les annotations du type spécifié de ce XObjecttype .

(Hérité de XObject)
RemoveNodes()

Supprime les nœuds enfants de ce document ou élément.

(Hérité de XContainer)
ReplaceNodes(Object)

Remplace les nœuds enfants de ce document ou élément par le contenu spécifié.

(Hérité de XContainer)
ReplaceNodes(Object[])

Remplace les nœuds enfants de ce document ou é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, SaveOptions)

Génère cette opération XDocument vers le comportement de mise en forme spécifié Stream, éventuellement en spécifiant le comportement de mise en forme.
Save(Stream)

Génère cette opération XDocument vers le fichier spécifié Stream.
Save(String, SaveOptions)

Sérialisez-le XDocument dans un fichier, en désactivant éventuellement la mise en forme.
Save(String)

Sérialisez-le XDocument dans un fichier, en remplaçant un fichier existant, s’il existe.
Save(TextWriter, SaveOptions)

Sérialisez-le XDocument sur une TextWritermise en forme facultative.
Save(TextWriter)

Sérialisez-le XDocument vers un TextWriter.
Save(XmlWriter)

Sérialisez-le XDocument vers un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Sortie de ceci XDocument vers un Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Écrit ceci XDocument dans un TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Écrit ceci XDocument dans un XmlWriterfichier .
ToString()

Retourne le code XML mis en retrait pour ce nœud.

(Hérité de XNode)
ToString(SaveOptions)

Retourne le code XML de ce nœud, en désactivant éventuellement la mise en forme.

(Hérité de XNode)
WriteTo(XmlWriter)

Écrivez ce document dans un XmlWriterfichier .
WriteToAsync(XmlWriter, CancellationToken)

Écrit l’arborescence XML sous-jacente de ce XDocument dans l’arborescence XML spécifiée XmlWriter.

Événements

Nom Description
Changed

Déclenché lorsque cela XObject ou l’un de ses descendants ont changé.

(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

Nom Description
IXmlLineInfo.HasLineInfo()

Obtient une valeur indiquant si cela XObject contient ou non des informations de ligne.

(Hérité de XObject)
IXmlLineInfo.LineNumber

Obtient le numéro de ligne signalé par le sous-jacent XmlReader pour ce XObject.

(Hérité de XObject)
IXmlLineInfo.LinePosition

Obtient la position de ligne signalée par le sous-jacent XmlReader pour ce XObject.

(Hérité de XObject)

Méthodes d’extension

Nom Description
CreateNavigator(XNode, XmlNameTable)

Crée un XPathNavigator pour un XNode. Le XmlNameTable traitement des expressions XPath est plus efficace.
CreateNavigator(XNode)

Crée un XPathNavigator pour un XNode.
ToXPathNavigable(XNode)

Retourne un accesseur qui vous permet de naviguer et de modifier le fichier spécifié XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Valide qu’un XDocument XSD est conforme à un XSD dans une XmlSchemaSetarborescence XML, éventuellement en remplit l’arborescence XML avec l’ensemble d’informations post-validation de schéma (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Cette méthode valide qu’un XDocument XSD est conforme à un XSD dans un XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Évalue une expression XPath, en résolvant les préfixes d’espace de noms à l’aide du préfixe spécifié IXmlNamespaceResolver.
XPathEvaluate(XNode, String)

Évalue une expression XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Sélectionne une XElement expression XPath en résolvant les préfixes d’espace de noms à l’aide de l’expression spécifiée IXmlNamespaceResolver.
XPathSelectElement(XNode, String)

Sélectionne une XElement expression XPath à 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 de l’élément spécifié IXmlNamespaceResolver.
XPathSelectElements(XNode, String)

Sélectionne une collection d’éléments à l’aide d’une expression XPath.

S’applique à

Voir aussi