Freigeben über

XNode.AddBeforeSelf Methode

  • Referenz

Definition

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

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:

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

<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

Gilt für:

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

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:

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

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 Funktion auf Ihre Leistung auswirken.

Weitere Informationen

Gilt für: