XStreamingElement.ToString Método

Definição

Espaço de Nomes:
System.Xml.Linq
Assemblagens:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblagens:
netstandard.dll, System.Xml.XDocument.dll
Assemblagem:
System.Xml.XDocument.dll
Assemblagem:
System.Xml.Linq.dll
Assemblagem:
netstandard.dll

Devolve o XML deste elemento de streaming, desativando opcionalmente a formatação.

Sobrecargas

Name Description
ToString()

Devolve o XML formatado (indentado) para este elemento de streaming.
ToString(SaveOptions)

Devolve o XML deste elemento de streaming, desativando opcionalmente a formatação.

Observações

Note-se que, ao depurar um programa que usa XStreamingElement, mostrar o valor de um objeto faz com que o seu ToString método seja chamado. Isto faz com que o XML seja serializado. Se a semântica da sua consulta ao elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar comportamentos indesejáveis na sua experiência de depuração.

ToString()

Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs

Devolve o XML formatado (indentado) 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

Devoluções

String

A contendo String o XML indentado.

Exemplos

O exemplo seguinte mostra duas utilizações de ToString. A primeira utilização 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())

Este exemplo produz a seguinte saída:

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

Observações

Note-se que, ao depurar um programa que usa XStreamingElement, mostrar o valor de um objeto faz com que o seu ToString método seja chamado. Isto faz com que o XML seja serializado. Se a semântica da sua consulta ao elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar comportamentos indesejáveis na sua experiência de depuração.

Ver também

Aplica-se a

ToString(SaveOptions)

Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs
Origem:
XStreamingElement.cs

Devolve o XML deste elemento de streaming, desativando opcionalmente 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

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

Devoluções

String

A contendo String o XML.

Exemplos

O exemplo seguinte mostra duas utilizações de ToString. A primeira utilização 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())

Este exemplo produz a seguinte saída:

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

Observações

Note-se que, ao depurar um programa que usa XStreamingElement, mostrar o valor de um objeto faz com que o seu ToString método seja chamado. Isto faz com que o XML seja serializado. Se a semântica da sua consulta ao elemento de streaming for tal que o elemento de streaming só pode ser transmitido uma vez, isso pode causar comportamentos indesejáveis na sua experiência de depuração.

Ver também

Aplica-se a