XNode.AddBeforeSelf Methode

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

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

Überlädt

Name Beschreibung
AddBeforeSelf(Object)

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

Fügt den angegebenen Inhalt unmittelbar 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 an der gewünschten Position 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 zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter "Valid Content of XElement" und "XDocument Objects".

Diese Methode löst die Changed Ereignisse aus Changing .

Die XContainer untergeordneten Notizen werden als eine singly-verknüpfte Liste von XNode Objekten gespeichert. 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
Quelle:
XNode.cs
Quelle:
XNode.cs

Fügt den angegebenen Inhalt unmittelbar 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 Sammlung 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 zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter "Valid Content of XElement" und "XDocument Objects".

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

Die XContainer untergeordneten Knoten werden als eine miteinander verknüpfte Liste von XNode Objekten gespeichert. 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
Quelle:
XNode.cs
Quelle:
XNode.cs

Fügt den angegebenen Inhalt unmittelbar 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 an der gewünschten Position 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 zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter "Valid Content of XElement" und "XDocument Objects".

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

Die XContainer untergeordneten Knoten werden als eine miteinander verknüpfte Liste von XNode Objekten gespeichert. 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: