XStreamingElement.ToString Método

  • Referência

Definição

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.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
Origem:
XStreamingElement.cs
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

Aplica-se a

ToString(SaveOptions)

Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
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

Aplica-se a