XStreamingElement.ToString Methode

  • Referenz

Definition

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

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 System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

String

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

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", _
                        From el In srcTree.Elements() _
                        Where el.Value = 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

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:

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:
 System::String ^ ToString(System::Xml::Linq::SaveOptions options);
public string ToString (System.Xml.Linq.SaveOptions options);
override this.ToString : System.Xml.Linq.SaveOptions -> string
Public Function ToString (options As SaveOptions) As String

Parameter

options
SaveOptions

Ein SaveOptions, das Formatierungsverhalten angibt.

Gibt zurück

String

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

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", _
                        From el In srcTree.Elements() _
                        Where el.Value = 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

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: