C # | Метод Convert.ToString (String, IFormatProvider)
Этот метод используется для возврата указанного экземпляра строки, и фактическое преобразование не выполняется.
Синтаксис:
Параметры:
Возвращаемое значение: этот метод возвращает значение возвращается без изменений.
Ниже программы иллюстрируют использование метода Convert.ToString (String, IFormatProvider) :
Пример 1:
// C # программа для демонстрации
// Convert.ToString () метод
public static void Main()
// создание объекта CultureInfo
new CultureInfo( «en-US» );
// объявление и инициализация массива String
Console.Write( «Converted string value»
+ » from a specified string: » );
get (values[j], cultures);
catch (FormatException e)
Console.Write( «Exception Thrown: » );
catch (OverflowException e)
Console.Write( «Exception Thrown: » );
// Определение метода get ()
public static void get ( string s,
// преобразование строки в указанную строку
string val = Convert.ToString(s, cultures);
// отображаем преобразованное значение строки
Пример 2:
// C # программа для демонстрации
// Convert.ToString () метод
public static void Main()
// создание объекта CultureInfo
new CultureInfo( «en-US» );
// объявляем и инициализируем массив String
string value = «The Accidental Prime Minister» ;
Console.Write( «Converted String: » );
// преобразование строки в указанную строку
string val = Convert.ToString(value, cultures);
// отображаем преобразованное значение строки
Convert. To String Method
Definition
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Converts the specified value to its equivalent string representation.
Overloads
Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.
Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified double-precision floating-point number to its equivalent string representation.
Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.
Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.
Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.
Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information.
Returns the specified string instance; no actual conversion is performed.
Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified DateTime to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.
Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information.
Converts the value of the specified 32-bit unsigned integer to its equivalent string representation.
Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
Converts the specified Boolean value to its equivalent string representation.
Converts the value of the specified 8-bit unsigned integer to its equivalent string representation.
Converts the value of the specified Unicode character to its equivalent string representation.
Converts the value of the specified DateTime to its equivalent string representation.
Converts the value of the specified double-precision floating-point number to its equivalent string representation.
Converts the value of the specified 16-bit signed integer to its equivalent string representation.
Converts the value of the specified 32-bit signed integer to its equivalent string representation.
Converts the value of the specified decimal number to its equivalent string representation.
Converts the value of the specified object to its equivalent string representation.
Converts the value of the specified 8-bit signed integer to its equivalent string representation.
Converts the value of the specified single-precision floating-point number to its equivalent string representation.
Returns the specified string instance; no actual conversion is performed.
Converts the value of the specified 16-bit unsigned integer to its equivalent string representation.
Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.
Converts the specified Boolean value to its equivalent string representation.
Converts the value of the specified 64-bit signed integer to its equivalent string representation.
ToString(Int32, Int32)
Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.
Parameters
The 32-bit signed integer to convert.
The base of the return value, which must be 2, 8, 10, or 16.
Returns
Exceptions
toBase is not 2, 8, 10, or 16.
Examples
The following example converts each element in an integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.
Remarks
If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. If value is negative and toBase is 2, 8, or 16, the returned string uses two’s complement representation. This means that the high-order bit of the highest-order byte (bit 31) is interpreted as the sign bit. If the ToString(Int32, Int32) method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. Such methods include Convert.ToInt32(String, Int32) and Int32.Parse(String, NumberStyles).
Applies to
ToString(Decimal, IFormatProvider)
Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.
Parameters
The decimal number to convert.
An object that supplies culture-specific formatting information.
Returns
Examples
The following example converts each element in an array of Decimal values to its equivalent string representation in four different cultures.
Remarks
Applies to
ToString(Double, IFormatProvider)
Converts the value of the specified double-precision floating-point number to its equivalent string representation.
Parameters
The double-precision floating-point number to convert.
An object that supplies culture-specific formatting information.
Returns
Examples
The following example converts each element in an array of Double values to its equivalent string representation in four different cultures.
Remarks
This implementation is identical to Double.ToString(IFormatProvider)
Applies to
ToString(Int16, IFormatProvider)
Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Parameters
The 16-bit signed integer to convert.
An object that supplies culture-specific formatting information.
Returns
Examples
The following example defines a custom NumberFormatInfo class that defines its negative sign as the string «
» and its positive sign as the string «!». It then calls the ToString(Int16, IFormatProvider) method to convert each element in an array of 16-bit integers to its equivalent string representation. The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
Remarks
This implementation is identical to Int16.ToString(IFormatProvider).
Applies to
ToString(Int16, Int32)
Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.
Parameters
The 16-bit signed integer to convert.
The base of the return value, which must be 2, 8, 10, or 16.
Returns
Exceptions
toBase is not 2, 8, 10, or 16.
Examples
The following example converts each element in an array of 16-bit signed integers to its equivalent binary, octal, decimal, and hexadecimal string representations.
Remarks
If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. If value is negative and toBase is 2, 8, or 16, the returned string uses two’s complement representation. This means that the high-order bit of the high-order byte (bit 15) is interpreted as the sign bit. If the ToString(Int16, Int32) method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. Such methods include Convert.ToInt16(String, Int32) and Int16.Parse(String, NumberStyles).
Applies to
ToString(Int32, IFormatProvider)
Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Parameters
The 32-bit signed integer to convert.
An object that supplies culture-specific formatting information.
Returns
Examples
The following example defines a custom NumberFormatInfo class that defines its negative sign as the string «
» and its positive sign as the string «!». It then calls the ToString(Int32, IFormatProvider) method to convert each element in an array of integers to its equivalent string representation. The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
Remarks
This implementation is identical to Int32.ToString(IFormatProvider).
Applies to
ToString(Int64, IFormatProvider)
Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
Parameters
The 64-bit signed integer to convert.
An object that supplies culture-specific formatting information.
Returns
Examples
The following example defines a custom NumberFormatInfo class that defines its negative sign as the string «
» and its positive sign as the string «!». It then calls the ToString(Int64, IFormatProvider) method to convert each element in a long integer array to its equivalent string representation. The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
Remarks
This implementation is identical to Int64.ToString(IFormatProvider).
Applies to
ToString(UInt64)
This API is not CLS-compliant.
Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.
Parameters
The 64-bit unsigned integer to convert.
Returns
Examples
The following example converts each element in an unsigned long integer array to its equivalent string representation.
Remarks
This implementation is identical to UInt64.ToString().
Applies to
ToString(Object, IFormatProvider)
Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.
Parameters
An object that supplies culture-specific formatting information.
Returns
Examples
The following example defines a Temperature class that overrides the Object.ToString method but does not implement the IConvertible interface. The example illustrates how calls to the Convert.ToString(Object, IFormatProvider) method, in turn, call the Temperature.ToString method.
The following example defines a Temperature class that implements the IFormattable interface but does not implement the IConvertible interface. Its IFormattable.ToString implementation represents the Temperature value in Celsius, Fahrenheit, or Kelvin, depending on the format string. The example also defines a TemperatureProvider class that implements IFormatProvider and provides a randomly generated format string that is used by the IFormattable implementation of the Temperature class.
Remarks
Convert. To String Метод
Определение
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует указанное значение в его эквивалентное строковое представление.
Перегрузки
Преобразует значение заданного 32-битового целого числа со знаком в эквивалентное строковое представление в указанной системе счисления.
Преобразует значение заданного десятичного числа в эквивалентное строковое представление, используя указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного числа с плавающей запятой двойной точности в эквивалентное строковое представление.
Преобразует значение заданного 16-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 16-битового целого числа со знаком в эквивалентное строковое представление в указанной системе счисления.
Преобразует значение заданного 32-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 64-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 64-битового целого числа без знака в эквивалентное строковое представление.
Преобразует значение указанного объекта в эквивалентное строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует значение заданного 8-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного числа с плавающей запятой одиночной точности в эквивалентное строковое представление, используя указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Возвращает заданное строковое представление; фактическое преобразование не производится.
Преобразует значение заданного 16-битового целого числа без знака в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 32-битового целого числа без знака в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 64-битового целого числа без знака в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного объекта DateTime в эквивалентное строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Преобразует значение заданного 64-битового целого числа со знаком в эквивалентное строковое представление в указанной системе счисления.
Преобразует значение заданного знака Юникода в эквивалентное строковое представление, используя указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует значение заданного 32-битового целого числа без знака в эквивалентное строковое представление.
Преобразует значение заданного 8-битового целого числа без знака в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Преобразует указанное логическое значение в эквивалентное строковое представление.
Преобразует значение заданного 8-битового целого числа без знака в эквивалентное строковое представление.
Преобразует значение заданного знака Юникода в эквивалентное строковое представление.
Преобразует значение заданного объекта DateTime в эквивалентное строковое представление.
Преобразует значение заданного числа с плавающей запятой двойной точности в эквивалентное строковое представление.
Преобразует значение заданного 16-битового целого числа со знаком в эквивалентное строковое представление.
Преобразует значение заданного 32-битового целого числа со знаком в эквивалентное строковое представление.
Преобразует значение заданного десятичного числа в эквивалентное строковое представление.
Преобразует значение заданного объекта в эквивалентное строковое представление.
Преобразует значение заданного 8-битового целого числа со знаком в эквивалентное строковое представление.
Преобразует значение заданного числа с плавающей запятой одиночной точности в эквивалентное строковое представление.
Возвращает заданное строковое представление; фактическое преобразование не производится.
Преобразует значение заданного 16-битового целого числа без знака в эквивалентное строковое представление.
Преобразует значение заданного 8-битового целого числа без знака в эквивалентное строковое представление в указанной системе счисления.
Преобразует указанное логическое значение в эквивалентное строковое представление.
Преобразует значение заданного 64-битового целого числа со знаком в эквивалентное строковое представление.
ToString(Int32, Int32)
Преобразует значение заданного 32-битового целого числа со знаком в эквивалентное строковое представление в указанной системе счисления.
Параметры
32-разрядное целое число со знаком для преобразования.
Основание системы счисления возвращаемого значения, равное 2, 8, 10 или 16.
Возвращаемое значение
Исключения
toBase не равно 2, 8, 10 или 16.
Примеры
В следующем примере каждый элемент массива целых чисел преобразуется в эквивалентные двоичные, шестнадцатеричные, десятичные и шестнадцатеричные строковые представления.
Комментарии
Применяется к
ToString(Decimal, IFormatProvider)
Преобразует значение заданного десятичного числа в эквивалентное строковое представление, используя указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Параметры
Десятичное число для преобразования.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере каждый элемент массива значений преобразуется в Decimal эквивалентное строковое представление в четырех различных культурах.
Комментарии
Применяется к
ToString(Double, IFormatProvider)
Преобразует значение заданного числа с плавающей запятой двойной точности в эквивалентное строковое представление.
Параметры
Число с плавающей запятой двойной точности, которое нужно преобразовать.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере каждый элемент массива значений преобразуется в Double эквивалентное строковое представление в четырех различных культурах.
Комментарии
Применяется к
ToString(Int16, IFormatProvider)
Преобразует значение заданного 16-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Параметры
16-разрядное целое число со знаком для преобразования.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере определяется пользовательский NumberFormatInfo класс, определяющий отрицательный знак в виде строки «
» и его положительный знак в виде строки «!». Затем он вызывает ToString(Int16, IFormatProvider) метод для преобразования каждого элемента массива 16-разрядных целых чисел в эквивалентное строковое представление. Преобразование использует инвариантный язык и региональные параметры, а также пользовательский NumberFormatInfo объект.
Комментарии
Применяется к
ToString(Int16, Int32)
Преобразует значение заданного 16-битового целого числа со знаком в эквивалентное строковое представление в указанной системе счисления.
Параметры
16-разрядное целое число со знаком для преобразования.
Основание системы счисления возвращаемого значения, равное 2, 8, 10 или 16.
Возвращаемое значение
Исключения
toBase не равно 2, 8, 10 или 16.
Примеры
В следующем примере каждый элемент массива 16-разрядных целых чисел со знаком преобразуется в эквивалентные двоичные, восьмеричные, десятичные и шестнадцатеричные строковые представления.
Комментарии
Применяется к
ToString(Int32, IFormatProvider)
Преобразует значение заданного 32-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Параметры
32-разрядное целое число со знаком для преобразования.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере определяется пользовательский NumberFormatInfo класс, определяющий отрицательный знак в виде строки «
» и его положительный знак в виде строки «!». Затем он вызывает ToString(Int32, IFormatProvider) метод для преобразования каждого элемента массива целых чисел в эквивалентное строковое представление. Преобразование использует инвариантный язык и региональные параметры, а также пользовательский NumberFormatInfo объект.
Комментарии
Применяется к
ToString(Int64, IFormatProvider)
Преобразует значение заданного 64-битового целого числа со знаком в эквивалентное строковое представление, учитывая указанные сведения об особенностях форматирования, связанных с языком и региональными параметрами.
Параметры
64-разрядное целое число со знаком для преобразования.
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере определяется пользовательский NumberFormatInfo класс, определяющий отрицательный знак в виде строки «
» и его положительный знак в виде строки «!». Затем он вызывает ToString(Int64, IFormatProvider) метод для преобразования каждого элемента в длинном целочисленном массиве в эквивалентное строковое представление. Преобразование использует инвариантный язык и региональные параметры, а также пользовательский NumberFormatInfo объект.
Комментарии
Применяется к
ToString(UInt64)
Этот API несовместим с CLS.
Преобразует значение заданного 64-битового целого числа без знака в эквивалентное строковое представление.
Параметры
64-разрядное целое число без знака для преобразования.
Возвращаемое значение
Примеры
В следующем примере каждый элемент в массиве длинных целых чисел без знака преобразуется в эквивалентное строковое представление.
Комментарии
Применяется к
ToString(Object, IFormatProvider)
Преобразует значение указанного объекта в эквивалентное строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
Параметры
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Примеры
В следующем примере определяется Temperature класс, который переопределяет Object.ToString метод, но не реализует IConvertible интерфейс. В примере показано, как вызовы Convert.ToString(Object, IFormatProvider) метода, в свою очередь, вызывают Temperature.ToString метод.
В следующем примере определяется Temperature класс, реализующий IFormattable интерфейс, но не реализующий IConvertible интерфейс. Его IFormattable.ToString реализация представляет Temperature значение в градусах Цельсия, Фаренгейта или Кельвина в зависимости от строки формата. В примере также определяется TemperatureProvider класс, реализующий интерфейс IFormatProvider и предоставляющий строку формата, созданную случайным образом, которая используется IFormattable реализацией Temperature класса.
