что такое tostring в c
Int32.To String Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
Перегрузки
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
ToString(IFormatProvider)
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Реализации
Примеры
В следующем примере показано строковое представление Int32 значения с помощью CultureInfo объектов, представляющих различные языки и региональные параметры.
Комментарии
ToString(IFormatProvider)Метод форматирует Int32 значение в формате по умолчанию («G» или «общий»), используя NumberFormatInfo объект указанной культуры. Если необходимо указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Конкретный формат | Культура по умолчанию (текущий) | ToString(String) |
| Конкретный формат | Конкретный язык и региональные параметры | ToString(String, IFormatProvider) |
provider Параметр — это объект, реализующий IFormatProvider интерфейс. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом, в зависимости от языка и региональных параметров. Объект, реализующий, IFormatProvider может быть любым из следующих:
CultureInfoОбъект, представляющий язык и региональные параметры, правила форматирования которых будут использоваться.
NumberFormatInfoОбъект, содержащий конкретные сведения о форматировании для этого значения.
Пользовательский объект, реализующий IFormatProvider метод и, GetFormat который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.
.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:
Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
См. также раздел
Применяется к
ToString(String, IFormatProvider)
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Стандартная или пользовательская строка числового формата.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Реализации
Исключения
format является недопустимым или не поддерживается.
Примеры
В следующем примере отображается положительное и отрицательное значение, использующее каждый из поддерживаемых стандартных описателей числового формата для трех различных языков и региональных параметров.
Комментарии
ToString(String, IFormatProvider)Метод форматирует Int32 значение в указанном формате, используя NumberFormatInfo объект указанного языка и региональных параметров. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Формат по умолчанию («G») | Конкретный язык и региональные параметры | ToString(IFormatProvider) |
| Конкретный формат | Культура по умолчанию (текущий) | ToString(String) |
format Параметр может быть либо стандартной, либо строкой настраиваемого числового формата. Поддерживаются все строки стандартного числового формата, отличные от «R» (или «r»), как и все пользовательские символы числового формата. Если format параметр имеет null значение или является пустой строкой («»), то возвращаемые значения для этого экземпляра форматируются с помощью описателя общего числового формата («G»).
provider Параметр — это объект, реализующий IFormatProvider интерфейс. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом, для определенного языка и региональных параметров. Объект, реализующий, IFormatProvider может быть любым из следующих:
CultureInfoОбъект, представляющий язык и региональные параметры, правила форматирования которых будут использоваться.
NumberFormatInfoОбъект, содержащий конкретные сведения о форматировании для этого значения.
Пользовательский объект, реализующий IFormatProvider метод и, GetFormat который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.
.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:
Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
UInt16.To String Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
Перегрузки
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
ToString(IFormatProvider)
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Строковое представление значения данного экземпляра, состоящее из последовательности цифр от 0 до 9 без знака и нулей в начале.
Реализации
Примеры
В следующем примере 16-разрядное целое число со знаком форматируется с помощью нескольких поставщиков формата, включая один для инвариантного языка и региональных параметров. Выходные данные в примере показывают, что отформатированная строка, возвращаемая ToString(IFormatProvider) методом, одинакова независимо от поставщика формата.
Комментарии
ToString(IFormatProvider)Метод форматирует UInt16 значение в формате по умолчанию («G» или «общий»), используя NumberFormatInfo объект указанной культуры. Если необходимо указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Конкретный формат | Культура по умолчанию (текущий) | ToString(String) |
| Конкретный формат | Конкретный язык и региональные параметры | ToString(String, IFormatProvider) |
provider Параметр является IFormatProvider реализацией. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения об особенностях форматирования, связанных с языком и региональными параметрами. Однако ни одно из свойств объекта NumberFormatInfo не используется при форматировании с помощью описателя общего числового формата («G»).
См. также раздел
Применяется к
ToString(String, IFormatProvider)
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Строка числового формата.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Реализации
Исключения
Примеры
В следующем примере отображается 16-разрядное целое число без знака с помощью стандартных описателей числового формата и ряда конкретных CultureInfo объектов.
Комментарии
ToString(String, IFormatProvider)Метод форматирует UInt16 значение в указанном формате, используя NumberFormatInfo объект указанного языка и региональных параметров. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Формат по умолчанию («G») | Конкретный язык и региональные параметры | ToString(IFormatProvider) |
| Конкретный формат | Культура по умолчанию (текущий) | ToString(String) |
.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:
Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
provider Параметр является IFormatProvider реализацией. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате строки, возвращаемой этим методом, в зависимости от языка и региональных параметров. При ToString(String, IFormatProvider) вызове метода он вызывает provider IFormatProvider.GetFormat метод параметра и передает ему Type объект, представляющий NumberFormatInfo тип. GetFormatЗатем метод возвращает NumberFormatInfo объект, предоставляющий сведения для форматирования текущего UInt16 значения, например символ разделителя группы или символ десятичной запятой. Существует три способа использования provider параметра для предоставления сведений о форматировании ToString(String, IFormatProvider) методу:
Можно передать CultureInfo объект, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании числовых значений для этого языка и региональных параметров.
Можно передать фактический NumberFormatInfo объект, предоставляющий сведения о форматировании чисел. (Его реализация GetFormat просто возвращает сам себя.)
Single. To String Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
Перегрузки
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
ToString(String, IFormatProvider)
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Строка числового формата.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Реализации
Примеры
В следующем примере отображается Single значение с использованием каждого из поддерживаемых стандартных описателей числового формата для нескольких различных языков и региональных параметров.
Комментарии
ToString(String, IFormatProvider)Метод форматирует Single значение в указанном формате указанного языка и региональных параметров. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Формат по умолчанию («G») | Конкретный язык и региональные параметры | ToString(IFormatProvider) |
| Конкретный формат | Культура по умолчанию (текущий) | ToString(String) |
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 метода следующим образом:
| Использование формата | Для языка и региональных параметров | Использование перегрузки |
|---|---|---|
| Формат по умолчанию («G») | Культура по умолчанию (текущий) | ToString() |
| Формат по умолчанию («G») | Конкретный язык и региональные параметры | ToString(IFormatProvider) |
| Конкретный формат | Конкретный язык и региональные параметры | ToString(String, IFormatProvider) |
format Параметр может быть любым допустимым описателем стандартного числового формата, за исключением D и X, а также любого сочетания настраиваемых описателей числового формата. Если параметр format имеет null значение или является пустой строкой, то возвращаемый результат форматируется с помощью описателя общего числового формата («G»).
.NET обеспечивает обширную поддержку форматирования, которая подробно описывается в следующих разделах форматирования:
Дополнительные сведения о спецификаторах числовых форматов см. в разделе строки стандартных числовых форматов и строки настраиваемых числовых форматов.
Дополнительные сведения о форматировании см. в разделе Типы форматирования.
По умолчанию возвращаемое значение содержит только 7 цифр точности, хотя для внутренних целей поддерживается не более 9 цифр. Если значение этого экземпляра превышает 7 цифр, ToString(String) возвращает PositiveInfinitySymbol или NegativeInfinitySymbol вместо ожидаемого числа. Если требуется дополнительная точность, укажите format с помощью спецификации формата «G9», которая всегда возвращает 9 цифр точности, или «R», которая возвращает 7 цифр, если число может быть представлено с точностью до этой цифры или 9 цифр, если число может быть представлено только с максимальной точностью.
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() методом, не зависит от языка и региональных параметров.
| Элемент | Описание |
|---|---|
| «-« | Знак «минус», обозначающий отрицательный интервал времени. Знак с положительным периодом времени не включается. |
| «d« | Число дней в интервале времени. Этот элемент опускается, если интервал времени меньше одного дня. |
| «HH« | Количество часов в интервале времени, в диапазоне от 0 до 23. |
| «mm« | Количество минут в интервале времени, в диапазоне от 0 до 59. |
| «SS» | Количество секунд в интервале времени, в диапазоне от 0 до 59. |
| «fffffff« | Доли секунды в интервале времени. Этот элемент опускается, если интервал времени не включает доли секунды. При наличии доли секунды всегда выражаются с использованием семи десятичных цифр. |