XContainer.AddFirst XContainer.AddFirst XContainer.AddFirst XContainer.AddFirst Method

Definition

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

Überlädt

AddFirst(Object) AddFirst(Object) AddFirst(Object) AddFirst(Object)

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

AddFirst(Object[]) AddFirst(Object[]) AddFirst(Object[]) AddFirst(Object[])

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

Beispiele

Im folgenden Beispiel erstellt zwei XML-Strukturen, und klicken Sie dann mithilfe dieser Methode die Ergebnisse einer Abfrage einen der Verträge 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.AddFirst(  
    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.AddFirst( _  
    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>  
  <Element3>3</Element3>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewElement>Content</NewElement>  
</Root>  

Hinweise

Diese Methode fügt den neuen Inhalt vor dem vorhandenen Inhalt der XContainer.This method adds the new content before the existing content of the XContainer.

Weitere Informationen zu den gültigen Inhalt, der an diese Funktion übergeben werden kann, 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 löst die Changed und Changing Ereignisse.This method will raise the Changed and the Changing events.

AddFirst(Object) AddFirst(Object) AddFirst(Object) AddFirst(Object)

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

public:
 void AddFirst(System::Object ^ content);
public void AddFirst (object content);
member this.AddFirst : obj -> unit
Public Sub AddFirst (content As Object)

Parameter

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

Das folgende Beispiel erstellt zwei XML-Strukturen, verwendet diese Methode zum Hinzufügen einer XElement Objekt als erstes Element einen der Verträge.The following example creates two XML trees, uses this method to add an XElement object as the first element to one of them. Es fügt auch die Ergebnisse einer LINQLINQ Abfrage, die die XML-Struktur.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.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    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.AddFirst(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.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    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.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Diese Methode fügt den neuen Inhalt vor dem vorhandenen Inhalt der XContainer.This method adds the new content before the existing content of the XContainer.

Weitere Informationen zu den gültigen Inhalt, der an diese Funktion übergeben werden kann, 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 löst die Changed und Changing Ereignisse.This method will raise the Changed and the Changing events.

Siehe auch

AddFirst(Object[]) AddFirst(Object[]) AddFirst(Object[]) AddFirst(Object[])

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

public:
 void AddFirst(... cli::array <System::Object ^> ^ content);
public void AddFirst (params object[] content);
member this.AddFirst : obj[] -> unit
Public Sub AddFirst (ParamArray content As Object())

Parameter

content
Object[]

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

Ausnahmen

Beispiele

Das folgende Beispiel erstellt zwei XML-Strukturen und verwendet diese Methode zum Hinzufügen einer XElement Objekt als erstes Element einen der Verträge.The following example creates two XML trees, and uses this method to add an XElement object as the first element to one of them. Es fügt auch die Ergebnisse einer LINQLINQ Abfrage, die die XML-Struktur.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.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    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.AddFirst(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.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    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.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Diese Methode fügt den neuen Inhalt vor dem vorhandenen Inhalt der XContainer.This method adds the new content before the existing content of the XContainer.

Weitere Informationen zu den gültigen Inhalt, der an diese Funktion übergeben werden kann, 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 löst die Changed und Changing Ereignisse.This method will raise the Changed and the Changing events.

Siehe auch

Gilt für: