Ler em inglês

Partilhar via


String.ToString Método

Definição

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

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

public override string ToString ();

Retornos

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 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
*/

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(IFormatProvider)

Origem:
String.cs
Origem:
String.cs
Origem:
String.cs

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

public string ToString (IFormatProvider? provider);
public string ToString (IFormatProvider provider);

Parâmetros

provider
IFormatProvider

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

Retornos

A cadeia de caracteres atual.

Implementações

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.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1