XStreamingElement.ToString Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Sestavení:

System.Xml.Linq.dll

Sestavení:

netstandard.dll

Vrátí XML pro tento prvek streamování, volitelně zakázání formátování.

Přetížení

ToString()	Vrátí formátovaný (odsazený) XML pro tento prvek streamování.
ToString(SaveOptions)	Vrátí xml pro tento element streamování, volitelně zakázání formátování.

Poznámky

Všimněte si, že při ladění programu, který používá XStreamingElement, zobrazení hodnoty objektu způsobí volání jeho ToString metody. To způsobí serializaci XML. Pokud je sémantika dotazu prvku streamování taková, že prvek streamování lze streamovat pouze jednou, může to způsobit nežádoucí chování v prostředí ladění.

ToString()

Vrátí formátovaný (odsazený) XML pro tento prvek streamování.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Návraty

String

A String obsahující odsazený KÓD XML.

Příklady

Následující příklad ukazuje dvě použití ToString. První použití zachovává prázdné místo. Druhý serializuje XStreamingElement formát.

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

Tento příklad vytvoří následující výstup:

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

Poznámky

Všimněte si, že při ladění programu, který používá XStreamingElement, zobrazení hodnoty objektu způsobí volání jeho ToString metody. To způsobí serializaci XML. Pokud je sémantika dotazu prvku streamování taková, že prvek streamování lze streamovat pouze jednou, může to způsobit nežádoucí chování v prostředí ladění.

Viz také

• Přehled LINQ to XML

ToString(SaveOptions)

Vrátí xml pro tento element streamování, volitelně zakázání formátování.

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

Parametry

options

SaveOptions

Určuje SaveOptions chování formátování.

Návraty

String

A String obsahující xml.

Příklady

Následující příklad ukazuje dvě použití ToString. První použití zachovává prázdné znaky. Druhý serializuje XStreamingElement s formátováním.

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

Tento příklad vytvoří následující výstup:

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

Poznámky

Všimněte si, že při ladění programu, který používá XStreamingElement, zobrazení hodnoty objektu způsobí, že jeho ToString metoda bude volána. To způsobí serializaci XML. Pokud je sémantika dotazu prvku streamování taková, že element streamování lze streamovat pouze jednou, může to způsobit nežádoucí chování v prostředí ladění.

Viz také

• Přehled LINQ to XML