XStreamingElement.ToString Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Retorna o XML para este elemento de streaming, se desejar desabilitar a formatação.

Sobrecargas

ToString()	Retorna o XML formatado (recuado) para este elemento de streaming.
ToString(SaveOptions)	Retorna o XML para este elemento de streaming, se desejar desabilitar a formatação.

Comentários

Observe que, ao depurar um programa que usa XStreamingElement, exibir o valor de um objeto faz com que seu ToString método seja chamado. Isso faz com que o XML seja serializado. Se a semântica da consulta de elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar um comportamento indesejável em sua experiência de depuração.

ToString()

Origem:

XStreamingElement.cs

Retorna o XML formatado (recuado) para este elemento de streaming.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

Uma String que contém o XML recuado.

Exemplos

O exemplo a seguir mostra dois usos de ToString. O primeiro uso preserva o espaço em branco. O segundo serializa o XStreamingElement com formatação.

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

Esse exemplo gera a saída a seguir:

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

Comentários

Observe que, ao depurar um programa que usa XStreamingElement, exibir o valor de um objeto faz com que seu ToString método seja chamado. Isso faz com que o XML seja serializado. Se a semântica da consulta de elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar um comportamento indesejável em sua experiência de depuração.

Confira também

• Visão geral do LINQ to XML

ToString(SaveOptions)

Origem:

XStreamingElement.cs

Retorna o XML para este elemento de streaming, se desejar desabilitar a formatação.

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

Parâmetros

options

SaveOptions

Um SaveOptions que especifica o comportamento de formatação.

Retornos

String

Um String que contém o XML.

Exemplos

O exemplo a seguir mostra dois usos de ToString. O primeiro uso preserva o espaço em branco. O segundo serializa o XStreamingElement com formatação.

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

Esse exemplo gera a saída a seguir:

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

Comentários

Observe que, ao depurar um programa que usa XStreamingElement, exibir o valor de um objeto faz com que seu ToString método seja chamado. Isso faz com que o XML seja serializado. Se a semântica da consulta de elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar um comportamento indesejável em sua experiência de depuração.

Confira também

• Visão geral do LINQ to XML