Auf Englisch lesen

Freigeben über


XStreamingElement.Add Methode

Definition

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
Quelle:
XStreamingElement.cs
Quelle:
XStreamingElement.cs

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

public void Add (object content);
public void Add (object? content);

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

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

Gilt für:

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

Add(Object[])

Quelle:
XStreamingElement.cs
Quelle:
XStreamingElement.cs
Quelle:
XStreamingElement.cs

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

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

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

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

Gilt für:

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