XContainer.Add Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Fügt diesem XContainer den angegebenen Inhalt als untergeordnetes Element hinzu.

Überlädt

Add(Object)	Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.
Add(Object[])	Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt und dann mit dieser Methode die Ergebnisse einer Abfrage zu einer von ihnen hinzugefügt.

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)  

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Diese Methode fügt den neuen Inhalt nach dem vorhandenen Inhalt von XContainerhinzu.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Add(Object)

Source:

XContainer.cs

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.

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

public void Add (object? content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

Parameter

content

Object

Ein Inhaltsobjekt, das einfache Inhalte oder eine Auflistung von Inhaltsobjekten enthält, die hinzugefügt werden sollen.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt und dann mit dieser Methode ein XElement Objekt zu einer dieser Strukturen hinzugefügt. Außerdem werden die Ergebnisse einer LINQ-Abfrage der XML-Struktur hinzugefügt.

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)  

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Diese Methode fügt den neuen Inhalt nach dem vorhandenen Inhalt von XContainerhinzu.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Weitere Informationen

• AddFirst
• RemoveNodes()
• ReplaceNodes
• Übersicht über LINQ to XML

Add(Object[])

Source:

XContainer.cs

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.

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

Parameter

content

Object[]

Eine Parameterliste von Inhaltsobjekten.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt und mit dieser Methode ein XElement Objekt hinzugefügt. Außerdem werden die Ergebnisse einer LINQ-Abfrage der XML-Struktur hinzugefügt.

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)  

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Diese Methode fügt den neuen Inhalt nach dem vorhandenen Inhalt von XContainerhinzu.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Weitere Informationen

• AddFirst
• RemoveNodes()
• ReplaceNodes
• Übersicht über LINQ to XML