XContainer.Add Méthode

Définition

Espace de noms:: System.Xml.Linq

Assemblys:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute le contenu spécifié en tant qu’enfants à cet objet XContainer.

Surcharges

Nom	Description
Add(Object)	Ajoute le contenu spécifié en tant qu’enfants de ce XContainer.
Add(Object[])	Ajoute le contenu spécifié en tant qu’enfants de ce XContainer.

Exemples

L’exemple suivant crée deux arborescences XML, puis utilise cette méthode pour ajouter les résultats d’une requête à l’une d’entre elles.

XElement srcTree = new XElement("Root",
    new XElement("Element1", 1),
    new XElement("Element2", 2),
    new XElement("Element3", 3),
    new XElement("Element4", 4),
    new XElement("Element5", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("NewElement", "Content")
);
xmlTree.Add(
    from el in srcTree.Elements()
    where (int)el >= 3
    select el
);
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _
        <Root>
            <Element1>1</Element1>
            <Element2>2</Element2>
            <Element3>3</Element3>
            <Element4>4</Element4>
            <Element5>5</Element5>
        </Root>
Dim xmlTree As XElement = _
        <Root>
            <NewElement>Content</NewElement>
        </Root>
xmlTree.Add( _
    From el In srcTree.Elements _
    Where CInt(el) >= 3 _
    Select el)
Console.WriteLine(xmlTree)

Cet exemple produit la sortie suivante :

<Root>
  <NewElement>Content</NewElement>
  <Element3>3</Element3>
  <Element4>4</Element4>
  <Element5>5</Element5>
</Root>

Remarques

Cette méthode ajoute le nouveau contenu après le contenu existant du XContainer.

Pour plus d’informations sur le contenu valide qui peut être transmis à cette fonction, consultez Contenu valide des objets XElement et XDocument.

Cette méthode déclenche les Changed événements et les Changing événements.

Add(Object)

Ajoute le contenu spécifié en tant qu’enfants de ce XContainer.

public:
 void Add(System::Object ^ content);

public void Add(object content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

Paramètres

content: Object

Objet de contenu contenant du contenu simple ou une collection d’objets de contenu à ajouter.

Exemples

L’exemple suivant crée deux arborescences XML, puis utilise cette méthode pour ajouter un XElement objet à l’un d’entre eux. Il ajoute également les résultats d’une requête LINQ à l’arborescence XML.

XElement srcTree = new XElement("Root",
    new XElement("Element1", 1),
    new XElement("Element2", 2),
    new XElement("Element3", 3),
    new XElement("Element4", 4),
    new XElement("Element5", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5)
);
xmlTree.Add(new XElement("NewChild", "new content"));
xmlTree.Add(
    from el in srcTree.Elements()
    where (int)el > 3
    select el
);
// Even though Child9 does not exist in srcTree, the following statement will not
// throw an exception, and nothing will be added to xmlTree.
xmlTree.Add(srcTree.Element("Child9"));
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _
        <Root>
            <Element1>1</Element1>
            <Element2>2</Element2>
            <Element3>3</Element3>
            <Element4>4</Element4>
            <Element5>5</Element5>
        </Root>

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

xmlTree.Add(New XElement("NewChild", "new content"))
xmlTree.Add( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el _
)
' Even though Child9 does not exist in srcTree, the following statement will not
' throw an exception, and nothing will be added to xmlTree.
xmlTree.Add(srcTree.<Child9>)
Console.WriteLine(xmlTree)

Cet exemple produit la sortie suivante :

<Root>
  <Child1>1</Child1>
  <Child2>2</Child2>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
  <NewChild>new content</NewChild>
  <Element4>4</Element4>
  <Element5>5</Element5>
</Root>

Remarques

Cette méthode ajoute le nouveau contenu après le contenu existant du XContainer.

Pour plus d’informations sur le contenu valide qui peut être transmis à cette fonction, consultez Contenu valide des objets XElement et XDocument.

Cette méthode déclenche les Changed événements et les Changing événements.

Voir aussi

S’applique à

Add(Object[])

Ajoute le contenu spécifié en tant qu’enfants de ce XContainer.

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

public void Add(params object[] content);

member this.Add : obj[] -> unit

Public Sub Add (ParamArray content As Object())

Paramètres

content: Object[]

Liste de paramètres d’objets de contenu.

Exemples

L’exemple suivant crée deux arborescences XML, utilise cette méthode pour ajouter un XElement objet à l’un d’entre eux. Il ajoute également les résultats d’une requête LINQ à l’arborescence XML.

XElement srcTree = new XElement("Root",
    new XElement("Element1", 1),
    new XElement("Element2", 2),
    new XElement("Element3", 3),
    new XElement("Element4", 4),
    new XElement("Element5", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5)
);
xmlTree.Add(new XElement("NewChild", "new content"));
xmlTree.Add(
    from el in srcTree.Elements()
    where (int)el > 3
    select el
);
// Even though Child9 does not exist in srcTree, the following statement will not
// throw an exception, and nothing will be added to xmlTree
xmlTree.Add(srcTree.Element("Child9"));
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _
        <Root>
            <Element1>1</Element1>
            <Element2>2</Element2>
            <Element3>3</Element3>
            <Element4>4</Element4>
            <Element5>5</Element5>
        </Root>

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

xmlTree.Add(New XElement("NewChild", "new content"))
xmlTree.Add( _
    From el In srcTree.Elements() _
    Where CInt(el) > 3 _
    Select el _
)
' Even though Child9 does not exist in srcTree, the following statement will not
' throw an exception, and nothing will be added to xmlTree
xmlTree.Add(srcTree.<Child9>)
Console.WriteLine(xmlTree)

Cet exemple produit la sortie suivante :

<Root>
  <Child1>1</Child1>
  <Child2>2</Child2>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
  <NewChild>new content</NewChild>
  <Element4>4</Element4>
  <Element5>5</Element5>
</Root>

Remarques

Cette méthode ajoute le nouveau contenu après le contenu existant du XContainer.

Pour plus d’informations sur le contenu valide qui peut être transmis à cette fonction, consultez Contenu valide des objets XElement et XDocument.

Cette méthode déclenche les Changed événements et les Changing événements.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?