XStreamingElement.ToString Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das XML für dieses Streamingelement zurück, wobei optional die Formatierung deaktiviert wird.
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. |
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.
- 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
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:
.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 |
- 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
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:
.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 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: