String.ToString Метод

Определение

Преобразует значение данного экземпляра в String.

Перегрузки

ToString()

Возвращает этот экземпляр String; реальное преобразование не осуществляется.

ToString(IFormatProvider)

Возвращает этот экземпляр String; реальное преобразование не осуществляется.

ToString()

Исходный код:
String.cs
Исходный код:
String.cs
Исходный код:
String.cs

Возвращает этот экземпляр String; реальное преобразование не осуществляется.

C#
public override string ToString ();

Возвращаемое значение

Текущая строка.

Примеры

В следующем примере демонстрируется ToString метод . Обратите внимание, что в примере метод не вызывается явным ToString образом. Вместо этого метод вызывается неявно функцией составного форматирования .

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

Комментарии

Так как этот метод просто возвращает текущую строку без изменений, нет необходимости вызывать ее напрямую. Обычно он вызывается неявно в операции составного форматирования, как показано в примере.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.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)

Исходный код:
String.cs
Исходный код:
String.cs
Исходный код:
String.cs

Возвращает этот экземпляр String; реальное преобразование не осуществляется.

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

Параметры

provider
IFormatProvider

(Зарезервирован.) Объект, предоставляющий сведения о форматировании, связанные с определенным языком и региональными параметрами.

Возвращаемое значение

Текущая строка.

Реализации

Комментарии

provider зарезервирован и в настоящее время не участвует в этой операции.

Так как этот метод просто возвращает текущую строку без изменений, нет необходимости вызывать ее напрямую.

Применяется к

.NET 9 и другие версии
Продукт Версии
.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