Teilen über


XContainer.AddFirst Methode

Definition

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.

Überlädt

AddFirst(Object)

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.

AddFirst(Object[])

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements 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.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:

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

AddFirst(Object)

Quelle:
XContainer.cs
Quelle:
XContainer.cs
Quelle:
XContainer.cs

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.

public:
 void AddFirst(System::Object ^ content);
public void AddFirst (object content);
public void AddFirst (object? content);
member this.AddFirst : obj -> unit
Public Sub AddFirst (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 mit dieser Methode ein XElement -Objekt als erstes Element zu einer von ihnen 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.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:

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

Gilt für:

AddFirst(Object[])

Quelle:
XContainer.cs
Quelle:
XContainer.cs
Quelle:
XContainer.cs

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.

public:
 void AddFirst(... cli::array <System::Object ^> ^ content);
public void AddFirst (params 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.

Ausnahmen

Das übergeordnete Element ist null.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt und mit dieser Methode ein XElement -Objekt als erstes Element zu einer von ihnen 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.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:

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

Gilt für: