Teilen ü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(System::Object ^ content);
public void Add (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

Gilt für:

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(... cli::array <System::Object ^> ^ content);
public void Add (params 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

Gilt für: