XStreamingElement.Add Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Fügt diesem XStreamingElement den angegebenen Inhalt als untergeordnetes Element hinzu.

Überlädt

Add(Object)	Fügt diesem XStreamingElement den angegebenen Inhalt als untergeordnetes Element hinzu.
Add(Object[])	Fügt diesem XStreamingElement den angegebenen Inhalt als untergeordnetes Element hinzu.

Add(Object)

Quelle:

XStreamingElement.cs

Fügt diesem XStreamingElement den angegebenen Inhalt als untergeordnetes Element hinzu.

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

public void Add (object? content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

Parameter

content

Object

Inhalt, der dem Streamingelement hinzugefügt werden soll.

Beispiele

Im folgenden Beispiel wird eine neue XStreamingElementerstellt. Anschließend werden dem Streamingelement zwei Abfragen hinzugefügt. Die Abfragen werden erst durchlaufen, wenn das Streamingelement serialisiert wird.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot");

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el <= 1
    select new XElement("Child", (int)el)
);

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el >= 3
    select new XElement("DifferentChild", (int)el)
);

Console.WriteLine(dstTree);

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value <= 1 _
    Select <Child><%= el.Value %></Child> _
)

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value >= 3 _
    Select <DifferentChild><%= el.Value %></DifferentChild> _
)

Console.WriteLine(dstTree)

Dieses Beispiel erzeugt die folgende Ausgabe:

<NewRoot>
  <Child>1</Child>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Hinweise

Dieser Konstruktor fügt dem den angegebenen Inhalt und die XStreamingElementAttribute hinzu. Obwohl es häufig möglich ist, den XStreamingElement in einer einzelnen Anweisung zu erstellen, ist es manchmal bequemer, dem Streamingelement Inhalte inkrementell hinzuzufügen.

Abfragen werden erst durchlaufen, wenn serialisiert XStreamingElement wird. Dies steht im Gegensatz zur Verwendung von Abfragen für Inhalte für eine XElement, bei der Abfragen zum Zeitpunkt der Erstellung des neuen XElementdurchlaufen werden.

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

Weitere Informationen

• Übersicht über LINQ to XML

Add(Object[])

Quelle:

XStreamingElement.cs

Fügt diesem XStreamingElement den angegebenen Inhalt als untergeordnetes Element hinzu.

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

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

member this.Add : obj[] -> unit

Public Sub Add (ParamArray content As Object())

Parameter

content

Object[]

Inhalt, der dem Streamingelement hinzugefügt werden soll.

Beispiele

Im folgenden Beispiel wird eine neue XStreamingElementerstellt. Anschließend werden dem Streamingelement zwei Abfragen hinzugefügt. Die Abfragen werden erst durchlaufen, wenn das Streamingelement serialisiert wird.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot");

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el <= 1
    select new XElement("Child", (int)el)
);

dstTree.Add(
    from el in srcTree.Elements()
    where (int)el >= 3
    select new XElement("DifferentChild", (int)el)
);

Console.WriteLine(dstTree);

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value <= 1 _
    Select <Child><%= el.Value %></Child> _
)

dstTree.Add( _
    From el In srcTree.Elements() _
    Where el.Value >= 3 _
    Select <DifferentChild><%= el.Value %></DifferentChild> _
)

Console.WriteLine(dstTree)

Dieses Beispiel erzeugt die folgende Ausgabe:

<NewRoot>
  <Child>1</Child>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Hinweise

Dieser Konstruktor fügt dem den angegebenen Inhalt und die XStreamingElementAttribute hinzu. Obwohl es häufig möglich ist, den XStreamingElement in einer einzelnen Anweisung zu erstellen, ist es manchmal bequemer, dem Streamingelement Inhalte inkrementell hinzuzufügen.

Abfragen werden erst durchlaufen, wenn serialisiert XStreamingElement wird. Dies steht im Gegensatz zur Verwendung von Abfragen für Inhalte für eine XElement, bei der Abfragen zum Zeitpunkt der Erstellung des neuen XElementdurchlaufen werden.

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

Weitere Informationen

• Übersicht über LINQ to XML