String.ToString Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Converte o valor dessa instância em um String.

Sobrecargas

ToString()	Retorna esta instância do String; nenhuma conversão em si é executada.
ToString(IFormatProvider)	Retorna esta instância do String; nenhuma conversão em si é executada.

ToString()

Origem:

String.cs

Retorna esta instância do String; nenhuma conversão em si é executada.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

A cadeia de caracteres atual.

Exemplos

O exemplo a seguir demonstra o ToString método . Observe que o exemplo não chama explicitamente o ToString método . Em vez disso, o método é chamado implicitamente pelo recurso de formatação composta .

using namespace System;
int main()
{
   String^ str1 = "123";
   String^ str2 = "abc";
   Console::WriteLine( "Original str1: {0}", str1 );
   Console::WriteLine( "Original str2: {0}", str2 );
   Console::WriteLine( "str1 same as str2?: {0}", Object::ReferenceEquals( str1, str2 ) );
   str2 = str1;
   Console::WriteLine();
   Console::WriteLine( "New str2:      {0}", str2 );
   Console::WriteLine( "str1 same as str2?: {0}", Object::ReferenceEquals( str1, str2 ) );
}

/*
This code produces the following output:
Original str1: 123
Original str2: abc
str1 same as str2?: False

New str2:      123
str1 same as str2?: True
*/

using System;

class stringToString {
    public static void Main() {
    String str1 = "123";
    String str2 = "abc";

    Console.WriteLine("Original str1: {0}", str1);
    Console.WriteLine("Original str2: {0}", str2);
    Console.WriteLine("str1 same as str2?: {0}", Object.ReferenceEquals(str1, str2));

    str2 = str1.ToString();
    Console.WriteLine();
    Console.WriteLine("New str2:      {0}", str2);
    Console.WriteLine("str1 same as str2?: {0}", Object.ReferenceEquals(str1, str2));
    }
}
/*
This code produces the following output:
Original str1: 123
Original str2: abc
str1 same as str2?: False

New str2:      123
str1 same as str2?: True
*/

open System

[<EntryPoint>]
let main _ =
    let str1 = "123"
    let str2 = "abc"
    printfn $"Original str1: {str1}"
    printfn $"Original str2: {str2}"
    printfn $"str1 same as str2?: {Object.ReferenceEquals(str1, str2)}"

    let str2 = str1.ToString()
    printfn $"\nNew str2:      {str2}"
    printfn $"str1 same as str2?: {Object.ReferenceEquals(str1, str2)}"
    0

(*
This code produces the following output:
Original str1: 123
Original str2: abc
str1 same as str2?: False

New str2:      123
str1 same as str2?: True
*)

 _

Class stringToString
   
   Public Shared Sub Main()
      Dim str1 As [String] = "123"
      Dim str2 As [String] = "abc"
      
      Console.WriteLine("Original str1: {0}", str1)
      Console.WriteLine("Original str2: {0}", str2)
      Console.WriteLine("str1 same as str2?: {0}", [Object].ReferenceEquals(str1, str2))
      
      str2 = str1.ToString()
      Console.WriteLine()
      Console.WriteLine("New str2:      {0}", str2)
      Console.WriteLine("str1 same as str2?: {0}", [Object].ReferenceEquals(str1, str2))
   End Sub
End Class
'
'This code produces the following output:
'Original str1: 123
'Original str2: abc
'str1 same as str2?: False
'
'New str2:      123
'str1 same as str2?: True
'

Comentários

Como esse método simplesmente retorna a cadeia de caracteres atual inalterada, não é necessário chamá-la diretamente. Geralmente, ele é chamado implicitamente em uma operação de formatação composta, como mostra o exemplo.

Confira também

• Clone()

ToString(IFormatProvider)

Origem:

String.cs

Retorna esta instância do String; nenhuma conversão em si é executada.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parâmetros

provider

IFormatProvider

(Reservado) Um objeto que fornece informações de formatação específicas de cultura.

Retornos

String

A cadeia de caracteres atual.

Implementações

ToString(IFormatProvider)

Comentários

provider é reservado e não participa atualmente desta operação.

Como esse método simplesmente retorna a cadeia de caracteres atual inalterada, não é necessário chamá-la diretamente.