XNode.AddBeforeSelf Methode

Referenz

Definition

Namespace:: System.Xml.Linq

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

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

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.

Überlädt

AddBeforeSelf(Object)	Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.
AddBeforeSelf(Object[])	Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.

Beispiele

Im folgenden Beispiel wird eine LINQ-Abfrage verwendet, um eine IEnumerable<T> von XElementzu erstellen, die dann an diese Methode übergeben wird. Dadurch werden die Ergebnisse einer Abfrage der Struktur am gewünschten Speicherort 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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    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>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
From el In srcTree.Elements() _  
Where CInt(el) > 3 _  
Select el)  

Console.WriteLine(xmlTree)

Dieses Beispiel erzeugt die folgende Ausgabe:

XML

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

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Methode übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Der XContainer speichert seine untergeordneten Notizen als eine singlich verknüpfte Liste von XNode Objekten. Dies bedeutet, dass die AddBeforeSelf -Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.

AddBeforeSelf(Object)

Quelle:: XNode.cs

Quelle:: XNode.cs

Quelle:: XNode.cs

Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.

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

public void AddBeforeSelf(object content);

public void AddBeforeSelf(object? content);

member this.AddBeforeSelf : obj -> unit

Public Sub AddBeforeSelf (content As Object)

Parameter

content: Object

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

Ausnahmen

InvalidOperationException

Das übergeordnete Element ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um der Struktur ein Element hinzuzufügen.

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    new XElement("NewChild", 10)  
);  
Console.WriteLine(xmlTree);

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

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf(New XElement("NewChild", 10))  
Console.WriteLine(xmlTree)

Dieses Beispiel erzeugt die folgende Ausgabe:

XML

<Root>  
  <NewChild>10</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Methode übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Der XContainer speichert seine untergeordneten Knoten als eine singlich verknüpfte Liste von XNode Objekten. Dies bedeutet, dass die AddBeforeSelf -Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.

Weitere Informationen

Übersicht über LINQ to XML

Gilt für:

.NET 10 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

AddBeforeSelf(Object[])

Quelle:: XNode.cs

Quelle:: XNode.cs

Quelle:: XNode.cs

Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.

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

public void AddBeforeSelf(params object[] content);

public void AddBeforeSelf(params object?[] content);

member this.AddBeforeSelf : obj[] -> unit

Public Sub AddBeforeSelf (ParamArray content As Object())

Parameter

content: Object[]

Eine Parameterliste von Inhaltsobjekten.

Ausnahmen

InvalidOperationException

Das übergeordnete Element ist null.

Beispiele

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    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>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  

Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el)  

Console.WriteLine(xmlTree)

Dieses Beispiel erzeugt die folgende Ausgabe:

XML

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

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Methode übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Weitere Informationen

Übersicht über LINQ to XML

Gilt für:

.NET 10 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Teilen über

XNode.AddBeforeSelf Methode

Definition

Überlädt

Beispiele

Hinweise

AddBeforeSelf(Object)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

AddBeforeSelf(Object[])

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen