Auf Englisch lesen

Freigeben über


XStreamingElement.ToString Methode

Definition

Gibt das XML für dieses Streamingelement zurück, wobei optional die Formatierung deaktiviert wird.

Überlädt

ToString()

Gibt das formatierte (eingezogene) XML für dieses Streamingelement zurück.

ToString(SaveOptions)

Gibt das XML für dieses Streamingelement zurück, wobei optional die Formatierung deaktiviert wird.

Hinweise

Beachten Sie, dass beim Debuggen eines Programms, das verwendet XStreamingElement, durch die Anzeige des Werts eines Objekts ToString dessen Methode aufgerufen wird. Dies bewirkt, dass die XML-Datei serialisiert wird. Wenn die Semantik Ihrer Streamingelementabfrage so ist, dass das Streamingelement nur einmal gestreamt werden kann, kann dies zu unerwünschtem Verhalten in Ihrer Debugumgebung führen.

ToString()

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

Gibt das formatierte (eingezogene) XML für dieses Streamingelement zurück.

public override string ToString ();

Gibt zurück

Ein String, der das eingezogene XML enthält.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen von ToString. Bei der ersten Verwendung bleiben Leerzeichen erhalten. Der zweite serialisiert den XStreamingElement mit Formatierung.

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",
                        from el in srcTree.Elements()
                        where (int)el == 3
                        select new XElement("DifferentChild", (int)el)
                    );

Console.WriteLine(dstTree.ToString(SaveOptions.DisableFormatting));
Console.WriteLine("------");
Console.WriteLine(dstTree.ToString());

Dieses Beispiel erzeugt die folgende Ausgabe:

<NewRoot><DifferentChild>3</DifferentChild></NewRoot>
------
<NewRoot>
  <DifferentChild>3</DifferentChild>
</NewRoot>

Hinweise

Beachten Sie, dass beim Debuggen eines Programms, das verwendet XStreamingElement, durch die Anzeige des Werts eines Objekts ToString dessen Methode aufgerufen wird. Dies bewirkt, dass die XML-Datei serialisiert wird. Wenn die Semantik Ihrer Streamingelementabfrage so ist, dass das Streamingelement nur einmal gestreamt werden kann, kann dies zu unerwünschtem Verhalten in Ihrer Debugumgebung führen.

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

ToString(SaveOptions)

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

Gibt das XML für dieses Streamingelement zurück, wobei optional die Formatierung deaktiviert wird.

public string ToString (System.Xml.Linq.SaveOptions options);

Parameter

options
SaveOptions

Ein SaveOptions, das Formatierungsverhalten angibt.

Gibt zurück

Ein String mit dem XML.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen von ToString. Bei der ersten Verwendung bleiben Leerzeichen erhalten. Der zweite serialisiert den XStreamingElement mit Formatierung.

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",
                        from el in srcTree.Elements()
                        where (int)el == 3
                        select new XElement("DifferentChild", (int)el)
                    );

Console.WriteLine(dstTree.ToString(SaveOptions.DisableFormatting));
Console.WriteLine("------");
Console.WriteLine(dstTree.ToString());

Dieses Beispiel erzeugt die folgende Ausgabe:

<NewRoot><DifferentChild>3</DifferentChild></NewRoot>
------
<NewRoot>
  <DifferentChild>3</DifferentChild>
</NewRoot>

Hinweise

Beachten Sie, dass beim Debuggen eines Programms, das verwendet XStreamingElement, durch die Anzeige des Werts eines Objekts ToString dessen Methode aufgerufen wird. Dies bewirkt, dass die XML-Datei serialisiert wird. Wenn die Semantik Ihrer Streamingelementabfrage so ist, dass das Streamingelement nur einmal gestreamt werden kann, kann dies zu unerwünschtem Verhalten in Ihrer Debugumgebung führen.

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