XStreamingElement.ToString メソッド

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

アセンブリ:

System.Xml.Linq.dll

アセンブリ:

netstandard.dll

このストリーム要素に対して XML を返し、必要に応じて、書式設定を無効にします。

オーバーロード

ToString()	このストリーム要素に対して書式 (インデント) が設定された XML を返します。
ToString(SaveOptions)	このストリーム要素に対して XML を返し、必要に応じて、書式設定を無効にします。

注釈

使用 XStreamingElementするプログラムをデバッグするときに、オブジェクトの値を表示すると、その ToString メソッドが呼び出されることに注意してください。 これにより、XML がシリアル化されます。 ストリーミング要素クエリのセマンティクスでストリーミング要素を 1 回だけストリーミングできる場合は、デバッグ エクスペリエンスで望ましくない動作が発生する可能性があります。

ToString()

このストリーム要素に対して書式 (インデント) が設定された XML を返します。

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

戻り値

String

インデントが設定された XML を格納する String。

例

次の例は、次の 2 つの用途を ToString示しています。 最初の使用では空白が保持されます。 2 つ目は、書式設定を使用して XStreamingElement シリアル化します。

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

この例を実行すると、次の出力が生成されます。

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

注釈

使用 XStreamingElementするプログラムをデバッグするときに、オブジェクトの値を表示すると、その ToString メソッドが呼び出されることに注意してください。 これにより、XML がシリアル化されます。 ストリーミング要素クエリのセマンティクスでストリーミング要素を 1 回だけストリーミングできる場合は、デバッグ エクスペリエンスで望ましくない動作が発生する可能性があります。

こちらもご覧ください

• LINQ to XML の概要

ToString(SaveOptions)

このストリーム要素に対して XML を返し、必要に応じて、書式設定を無効にします。

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

パラメーター

options

SaveOptions

書式設定の動作を指定する SaveOptions。

戻り値

String

XML を格納している String。

例

次の例では、次の 2 つの用途を ToString示します。 最初の使用では、空白が保持されます。 2 つ目は、書式設定を使用して XStreamingElement シリアル化します。

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

この例を実行すると、次の出力が生成されます。

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

注釈

使用 XStreamingElementするプログラムをデバッグするときに、オブジェクトの値を表示すると、その ToString メソッドが呼び出されることに注意してください。 これにより、XML がシリアル化されます。 ストリーミング要素クエリのセマンティクスがストリーミング要素を 1 回しかストリーミングできない場合は、デバッグ エクスペリエンスで望ましくない動作が発生する可能性があります。

こちらもご覧ください

• LINQ to XML の概要