XContainer.Add Methode

Definition

Fügt diesem XContainer den angegebenen Inhalt als untergeordnetes Element hinzu.Adds the specified content as children to this XContainer.

Überlädt

Add(Object)

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this XContainer.

Add(Object[])

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this XContainer.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt. Anschließend wird diese Methode verwendet, um die Ergebnisse einer Abfrage einem von Ihnen hinzuzufügen.The following example creates two XML trees, and then uses this method to add the results of a query to one of them.

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:This example produces the following output:

<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.This method adds the new content after the existing content of the XContainer.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übermittelt werden können, finden Sie unter gültiger Inhalt von XElement-und XDocument-Objekten.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Diese Methode gibt das Changed -Ereignis und das Changing -Ereignis aus.This method will raise the Changed and the Changing events.

Add(Object)

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this XContainer.

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.A content object containing simple content or a collection of content objects to be added.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt. Anschließend wird diese Methode verwendet, XElement um einer davon ein Objekt hinzuzufügen.The following example creates two XML trees, and then uses this method to add an XElement object to one of them. Außerdem werden die Ergebnisse einer LINQLINQ Abfrage der XML-Struktur hinzugefügt.It also adds the results of a LINQLINQ query to the XML tree.

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:This example produces the following output:

<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.This method adds the new content after the existing content of the XContainer.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übermittelt werden können, finden Sie unter gültiger Inhalt von XElement-und XDocument-Objekten.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Diese Methode gibt das Changed -Ereignis und das Changing -Ereignis aus.This method will raise the Changed and the Changing events.

Siehe auch

Add(Object[])

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this 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())

Parameter

content
Object[]

Eine Parameterliste von Inhaltsobjekten.A parameter list of content objects.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt. diese Methode wird verwendet XElement , um einem von Ihnen ein Objekt hinzuzufügen.The following example creates two XML trees, uses this method to add an XElement object to one of them. Außerdem werden die Ergebnisse einer LINQLINQ Abfrage der XML-Struktur hinzugefügt.It also adds the results of a LINQLINQ query to the XML tree.

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:This example produces the following output:

<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.This method adds the new content after the existing content of the XContainer.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übermittelt werden können, finden Sie unter gültiger Inhalt von XElement-und XDocument-Objekten.For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

Diese Methode gibt das Changed -Ereignis und das Changing -Ereignis aus.This method will raise the Changed and the Changing events.

Siehe auch

Gilt für: