XDocument Constructeurs

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Initialise une nouvelle instance de la classe XDocument.

Surcharges

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(XDocument)	Initialise une nouvelle instance de la classe XDocument à partir d'un objet XDocument existant.
XDocument(XDeclaration, Object[])	Initialise une nouvelle instance de la classe XDocument avec la XDeclaration et le contenu spécifiés.

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

Les constructeurs surchargés vous permettent de créer un nouvel objet vide XDocument; pour créer un XDocument contenu initial spécifié et de créer une XDocument copie d’un autre XDocument objet.

Il n'existe pas beaucoup de scénarios qui requièrent la création d'un objet XDocument. Au lieu de cela, vous pouvez généralement créer vos arborescences XML avec un nœud racine XElement. À moins que la création d'un document ne soit spécifiquement requise (par exemple si vous devez créer des instructions de traitement et des commentaires au niveau supérieur ou si vous devez prendre en charge des types de documents), il est souvent plus commode d'utiliser XElement comme nœud racine.

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

XDocument()

Initialise une nouvelle instance de la classe XDocument.

public:
 XDocument();

public XDocument ();

Public Sub New ()

Exemples

L’exemple suivant crée un document, puis ajoute un commentaire et un élément à celui-ci.

XDocument doc = new XDocument();  
doc.Add(new XComment("This is a comment"));  
doc.Add(new XElement("Root", "content"));  
Console.WriteLine(doc);  

Dim doc As XDocument = New XDocument()  
doc.Add(<!--This is a comment-->)  
doc.Add(<Root>content</Root>)  
Console.WriteLine(doc)  

Cet exemple produit la sortie suivante :

<!--This is a comment-->  
<Root>content</Root>  

Remarques

Il n'existe pas beaucoup de scénarios qui requièrent la création d'un objet XDocument. Au lieu de cela, vous pouvez généralement créer vos arborescences XML avec un nœud racine XElement. À moins que la création d'un document ne soit spécifiquement requise (par exemple si vous devez créer des instructions de traitement et des commentaires au niveau supérieur ou si vous devez prendre en charge des types de documents), il est souvent plus commode d'utiliser XElement comme nœud racine.

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

Voir aussi

• Load
• Vue d’ensemble de LINQ to XML
• Vue d'ensemble de la classe XDocument

XDocument(Object[])

Initialise une nouvelle instance de la classe XDocument avec le contenu spécifié.

public:
 XDocument(... cli::array <System::Object ^> ^ content);

public XDocument (params object[] content);

public XDocument (params object?[] content);

new System.Xml.Linq.XDocument : obj[] -> System.Xml.Linq.XDocument

Public Sub New (ParamArray content As Object())

Paramètres

content

Object[]

Liste de paramètres d'objets de contenu à ajouter à ce document.

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

Il n'existe pas beaucoup de scénarios qui requièrent la création d'un objet XDocument. Au lieu de cela, vous pouvez généralement créer vos arborescences XML avec un nœud racine XElement. À moins que la création d'un document ne soit spécifiquement requise (par exemple si vous devez créer des instructions de traitement et des commentaires au niveau supérieur ou si vous devez prendre en charge des types de documents), il est souvent plus commode d'utiliser XElement comme nœud racine.

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

Voir aussi

• Load
• Vue d’ensemble de LINQ to XML
• Vue d'ensemble de la classe XDocument

XDocument(XDocument)

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

public:
 XDocument(System::Xml::Linq::XDocument ^ other);

public XDocument (System.Xml.Linq.XDocument other);

new System.Xml.Linq.XDocument : System.Xml.Linq.XDocument -> System.Xml.Linq.XDocument

Public Sub New (other As XDocument)

Paramètres

other

XDocument

Objet XDocument qui sera copié.

Remarques

Vous utilisez ce constructeur pour créer une copie approfondie d’un XDocument.

Ce constructeur traverse tous les nœuds et attributs du document spécifié dans le other paramètre et crée des copies de tous les nœuds, car il assemble le nouveau initialisé XDocument.

Voir aussi

• Load
• Vue d’ensemble de LINQ to XML
• Vue d'ensemble de la classe XDocument

XDocument(XDeclaration, Object[])

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

public:
 XDocument(System::Xml::Linq::XDeclaration ^ declaration, ... cli::array <System::Object ^> ^ content);

public XDocument (System.Xml.Linq.XDeclaration declaration, params object[] content);

public XDocument (System.Xml.Linq.XDeclaration? declaration, params object[] content);

public XDocument (System.Xml.Linq.XDeclaration? declaration, params object?[] content);

new System.Xml.Linq.XDocument : System.Xml.Linq.XDeclaration * obj[] -> System.Xml.Linq.XDocument

Public Sub New (declaration As XDeclaration, ParamArray content As Object())

Paramètres

declaration

XDeclaration

XDeclaration pour le document.

content

Object[]

Contenu du document.

Exemples

L’exemple suivant utilise ce constructeur pour créer un document.

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 XDeclaration("1.0", "utf-8", "yes"),  
    new XComment("This is a new comment"),  
    new XElement("Root",  
        from el in srcTree.Element("Root").Elements()  
        where ((string)el).StartsWith("data")  
        select el  
    )  
);  
doc.Save("Test.xml");  
Console.WriteLine(File.ReadAllText("Test.xml"));  

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 new comment-->  
        <Root>  
            <%= From el In srcTree.<Root>.Elements _  
                Where CStr(el).StartsWith("data") _  
                Select el %>  
        </Root>  
doc.Save("Test.xml")  
Console.WriteLine(File.ReadAllText("Test.xml"))  

Cet exemple produit la sortie suivante :

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<!--This is a new comment-->  
<Root>  
  <Child1>data1</Child1>  
  <Child2>data2</Child2>  
  <Child3>data3</Child3>  
  <Child2>data4</Child2>  
</Root>  

Remarques

Il n'existe pas beaucoup de scénarios qui requièrent la création d'un objet XDocument. Au lieu de cela, vous pouvez généralement créer vos arborescences XML avec un nœud racine XElement. À moins que la création d'un document ne soit spécifiquement requise (par exemple si vous devez créer des instructions de traitement et des commentaires au niveau supérieur ou si vous devez prendre en charge des types de documents), il est souvent plus commode d'utiliser XElement comme nœud racine.

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

Voir aussi

• Load
• Vue d’ensemble de LINQ to XML
• Vue d'ensemble de la classe XDocument