что такое tostring в c

Int32.To String Метод

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

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

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

ToString(IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.

Параметры

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

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

Реализации

Примеры

В следующем примере показано строковое представление Int32 значения с помощью CultureInfo объектов, представляющих различные языки и региональные параметры.

Комментарии

ToString(IFormatProvider)Метод форматирует Int32 значение в формате по умолчанию («G» или «общий»), используя NumberFormatInfo объект указанной культуры. Если необходимо указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

provider Параметр — это объект, реализующий IFormatProvider интерфейс. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом, в зависимости от языка и региональных параметров. Объект, реализующий, IFormatProvider может быть любым из следующих:

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

NumberFormatInfoОбъект, содержащий конкретные сведения о форматировании для этого значения.

Пользовательский объект, реализующий IFormatProvider метод и, GetFormat который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.

Дополнительные сведения о форматировании см. в разделе Типы форматирования.

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

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

ToString(String, IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

Параметры

Стандартная или пользовательская строка числового формата.

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

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

Реализации

Исключения

format является недопустимым или не поддерживается.

Примеры

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

Комментарии

ToString(String, IFormatProvider)Метод форматирует Int32 значение в указанном формате, используя NumberFormatInfo объект указанного языка и региональных параметров. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:

format Параметр может быть либо стандартной, либо строкой настраиваемого числового формата. Поддерживаются все строки стандартного числового формата, отличные от «R» (или «r»), как и все пользовательские символы числового формата. Если format параметр имеет null значение или является пустой строкой («»), то возвращаемые значения для этого экземпляра форматируются с помощью описателя общего числового формата («G»).

provider Параметр — это объект, реализующий IFormatProvider интерфейс. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом, для определенного языка и региональных параметров. Объект, реализующий, IFormatProvider может быть любым из следующих:

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

NumberFormatInfoОбъект, содержащий конкретные сведения о форматировании для этого значения.

Пользовательский объект, реализующий IFormatProvider метод и, GetFormat который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.

Дополнительные сведения о форматировании см. в разделе Типы форматирования.

Источник

String. To String Метод

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

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

ToString(IFormatProvider)

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

Параметры

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

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

Реализации

Комментарии

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

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

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

ToString()

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

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

Примеры

Комментарии

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

Источник

Single. To String Метод

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

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

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.

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

ToString(String, IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

Параметры

Строка числового формата.

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

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

Реализации

Примеры

В следующем примере отображается Single значение с использованием каждого из поддерживаемых стандартных описателей числового формата для нескольких различных языков и региональных параметров.

Комментарии

ToString(String, IFormatProvider)Метод форматирует Single значение в указанном формате указанного языка и региональных параметров. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:

format Параметр может быть любым допустимым описателем стандартного числового формата, за исключением D и X, а также любого сочетания настраиваемых описателей числового формата. Если format параметр имеет null значение или является пустой строкой, то возвращаемые значения для этого экземпляра форматируются с помощью описателя общего числового формата («G»).

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.

Дополнительные сведения о форматировании см. в разделе Типы форматирования.

provider Параметр — это IFormatProvider реализация, GetFormat метод которой возвращает NumberFormatInfo объект. Как правило, provider является CultureInfo объектом или NumberFormatInfo объектом. provider Параметр предоставляет сведения о языке и региональных параметрах, используемые при форматировании. Если provider параметр имеет null значение, возвращаемое значения форматируется с помощью NumberFormatInfo объекта для текущего языка и региональных параметров.

По умолчанию возвращаемое значение содержит только 7 цифр точности, хотя для внутренних целей поддерживается не более 9 цифр. Если значение этого экземпляра превышает 7 цифр, ToString возвращает PositiveInfinitySymbol или NegativeInfinitySymbol вместо ожидаемого числа. Если требуется дополнительная точность, укажите format с помощью спецификации формата «G9», которая всегда возвращает 9 цифр точности, или «R», которая возвращает 7 цифр, если число может быть представлено с точностью до этой цифры или 9 цифр, если число может быть представлено только с максимальной точностью.

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

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

ToString(String)

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

Параметры

Строка числового формата.

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

Исключения

Примеры

В следующем примере определяется числовое значение и форматируется как денежное значение с помощью строки стандартного числового формата «C», а в качестве числового значения для трех десятичных разрядов используется строка стандартного числового формата «N». Строки результатов форматируются с помощью соглашений языка и региональных параметров en-US. Дополнительные сведения о строках числового формата см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.

В следующем примере показано несколько Single значений, использующих каждый из поддерживаемых стандартных описателей числового формата вместе с двумя строками настраиваемого числового формата. Одна из этих строк настраиваемого формата показывает, как заполнить Single значение начальными нулями. При преобразовании числовых значений в строки в примере используются соглашения о форматировании для языка и региональных параметров en-US.

Комментарии

ToString(String)Метод форматирует Single значение в указанном формате, используя правила текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию («G» или «общий») или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

format Параметр может быть любым допустимым описателем стандартного числового формата, за исключением D и X, а также любого сочетания настраиваемых описателей числового формата. Если параметр format имеет null значение или является пустой строкой, то возвращаемый результат форматируется с помощью описателя общего числового формата («G»).

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.

Дополнительные сведения о форматировании см. в разделе Типы форматирования.

По умолчанию возвращаемое значение содержит только 7 цифр точности, хотя для внутренних целей поддерживается не более 9 цифр. Если значение этого экземпляра превышает 7 цифр, ToString(String) возвращает PositiveInfinitySymbol или NegativeInfinitySymbol вместо ожидаемого числа. Если требуется дополнительная точность, укажите format с помощью спецификации формата «G9», которая всегда возвращает 9 цифр точности, или «R», которая возвращает 7 цифр, если число может быть представлено с точностью до этой цифры или 9 цифр, если число может быть представлено только с максимальной точностью.

Источник

Enum. To String Метод

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

Эта перегрузка метода является устаревшей. Используйте ToString(String).

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

Перегруженная версия метода является устаревшей, вместо нее следует использовать метод ToString().

ToString()

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

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

Строковое представление значения этого экземпляра.

Примеры

В следующем примере показано преобразование перечислимого значения в строку.

Комментарии

Возвращаемое значение форматируется с помощью общего описателя формата («G»). То есть если объект FlagsAttribute не применяется к этому перечислимому типу и существует именованная константа, равная значению этого экземпляра, то возвращаемое значение является строкой, содержащей имя константы. Если FlagsAttribute применяется, и существует сочетание одной или нескольких именованных констант, равное значению этого экземпляра, то возвращаемое значение является строкой, содержащей разделенный разделителем список имен констант. В противном случае возвращаемое значение является строковым представлением числового значения данного экземпляра. Дополнительные сведения о форматировании значений перечисления см. в разделе строки формата перечисления. Дополнительные сведения о форматировании в целом см. в разделе Типы форматирования.

Примечания для тех, кто вызывает этот метод

Источник

Time Span. To String Метод

Определение

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

Перегрузки

Преобразует числовое значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием заданного формата.

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

ToString(String, IFormatProvider)

Преобразует числовое значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

Параметры

Стандартная или пользовательская строка формата TimeSpan.

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

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

Реализации

Исключения

Параметр format не распознается или не поддерживается.

Примеры

В следующем примере метод вызывается ToString(String, IFormatProvider) для форматирования двух временных интервалов. В примере метод дважды вызывается для каждой строки формата, сначала для его вывода с использованием правил языка и региональных параметров en-US, а затем для его вывода с использованием соглашений языка и региональных параметров fr-FR.

Комментарии

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

formatProvider Параметр — это IFormatProvider реализация, которая предоставляет сведения о формате возвращаемой строки, зависящей от языка и региональных параметров. formatProvider Параметр может быть любым из следующих:

CultureInfoОбъект, представляющий язык и региональные параметры, соглашения о форматировании которых должны быть отражены в возвращаемой строке. DateTimeFormatInfoОбъект, возвращаемый CultureInfo.DateTimeFormat свойством, определяет форматирование возвращаемой строки.

DateTimeFormatInfoОбъект, определяющий форматирование возвращаемой строки.

Пользовательский объект, реализующий IFormatProvider интерфейс. Его IFormatProvider.GetFormat метод возвращает DateTimeFormatInfo объект, предоставляющий сведения о форматировании.

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

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

ToString(String)

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием заданного формата.

Параметры

Стандартная или пользовательская строка формата TimeSpan.

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

Исключения

Параметр format не распознается или не поддерживается.

Примеры

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

Комментарии

Если format является строкой стандартного формата, формат возвращаемой строки определяется соглашениями о форматировании текущего языка и региональных параметров.

.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:

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

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

ToString()

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

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

Строковое представление значения текущего объекта TimeSpan.

Примеры

В следующем примере выводятся строки, возвращаемые путем вызова ToString метода с несколькими TimeSpan значениями. Обратите внимание, что хотя в примере не вызывается ToString метод напрямую, он вызывается Console.WriteLine методом при попытке преобразовать TimeSpan значение в его строковое представление.

Комментарии

Возвращаемая строка форматируется с помощью описателя формата «c» и имеет следующий формат:

Элементы в квадратных скобках ([и]) могут не включаться в возвращаемую строку. Двоеточия и точки (: и) являются литеральными символами. В следующей таблице перечислены элементы, не являющиеся литералами. Обратите внимание, что строка, возвращаемая ToString() методом, не зависит от языка и региональных параметров.

Примечания для тех, кто вызывает этот метод

Источник