Convert.ToString Método
Definição
Converte o valor especificado na representação de cadeia de caracteres equivalente.Converts the specified value to its equivalent string representation.
Sobrecargas
| ToString(Int32, Int32) |
Converte o valor de um inteiro com sinal de 32 bits na representação de cadeia de caracteres equivalente a ele em uma base especificada.Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base. |
| ToString(Decimal, IFormatProvider) |
Converte o valor do número decimal especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Double, IFormatProvider) |
Converte o valor do número de ponto flutuante de precisão dupla especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified double-precision floating-point number to its equivalent string representation. |
| ToString(Int16, IFormatProvider) |
Converte o valor do inteiro com sinal de 16 bits especificado em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Int16, Int32) |
Converte o valor de um inteiro com sinal de 16 bits em sua representação de cadeia de caracteres equivalente em uma base especificada.Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base. |
| ToString(Int32, IFormatProvider) |
Converte o valor do inteiro com sinal de 32 bits especificado em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Int64, IFormatProvider) |
Converte o valor do inteiro com sinal de 64 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(UInt64) |
Converte o valor do inteiro sem sinal de 64 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation. |
| ToString(Object, IFormatProvider) |
Converte o valor do objeto especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information. |
| ToString(SByte, IFormatProvider) |
Converte o valor do inteiro com sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Single, IFormatProvider) |
Converte o valor do número de ponto flutuante de precisão simples em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura.Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(String, IFormatProvider) |
Retorna a instância de cadeia de caracteres especificada; nenhuma conversão real é executada.Returns the specified string instance; no actual conversion is performed. |
| ToString(UInt16, IFormatProvider) |
Converte o valor do inteiro sem sinal de 16 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(UInt32, IFormatProvider) |
Converte o valor do inteiro sem sinal de 32 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(UInt64, IFormatProvider) |
Converte o valor do inteiro sem sinal de 64 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(DateTime, IFormatProvider) |
Converte o valor do DateTime especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura determinadas.Converts the value of the specified DateTime to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Int64, Int32) |
Converte o valor de um inteiro com sinal de 64 bits na representação de cadeia de caracteres equivalente a ele em uma base especificada.Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base. |
| ToString(Char, IFormatProvider) |
Converte o valor do caractere Unicode especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(UInt32) |
Converte o valor do inteiro sem sinal de 32 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation. |
| ToString(Byte, IFormatProvider) |
Converte o valor do inteiro sem sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information. |
| ToString(Boolean) |
Converte o valor booliano especificado na representação de cadeia de caracteres equivalente.Converts the specified Boolean value to its equivalent string representation. |
| ToString(Byte) |
Converte o valor do inteiro sem sinal de 8 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation. |
| ToString(Char) |
Converte o valor do caractere Unicode especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified Unicode character to its equivalent string representation. |
| ToString(DateTime) |
Converte o valor do DateTime especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified DateTime to its equivalent string representation. |
| ToString(Double) |
Converte o valor do número de ponto flutuante de precisão dupla especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified double-precision floating-point number to its equivalent string representation. |
| ToString(Int16) |
Converte o valor do inteiro com sinal de 16 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 16-bit signed integer to its equivalent string representation. |
| ToString(Int32) |
Converte o valor do inteiro com sinal de 32 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 32-bit signed integer to its equivalent string representation. |
| ToString(Decimal) |
Converte o valor do número decimal especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified decimal number to its equivalent string representation. |
| ToString(Object) |
Converte o valor do objeto especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified object to its equivalent string representation. |
| ToString(SByte) |
Converte o valor do inteiro com sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 8-bit signed integer to its equivalent string representation. |
| ToString(Single) |
Converte o valor do número de ponto flutuante de precisão simples especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified single-precision floating-point number to its equivalent string representation. |
| ToString(String) |
Retorna a instância de cadeia de caracteres especificada; nenhuma conversão real é executada.Returns the specified string instance; no actual conversion is performed. |
| ToString(UInt16) |
Converte o valor do inteiro sem sinal de 16 bits especificado em uma representação de cadeia de caracteres equivalente.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation. |
| ToString(Byte, Int32) |
Converte o valor de um inteiro sem sinal de 8 bits em sua representação de cadeia de caracteres equivalente de uma base especificada.Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base. |
| ToString(Boolean, IFormatProvider) |
Converte o valor booliano especificado na representação de cadeia de caracteres equivalente.Converts the specified Boolean value to its equivalent string representation. |
| ToString(Int64) |
Converte o valor do inteiro com sinal de 64 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 64-bit signed integer to its equivalent string representation. |
ToString(Int32, Int32)
Converte o valor de um inteiro com sinal de 32 bits na representação de cadeia de caracteres equivalente a ele em uma base especificada.Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.
public:
static System::String ^ ToString(int value, int toBase);
public static string ToString (int value, int toBase);
static member ToString : int * int -> string
Public Shared Function ToString (value As Integer, toBase As Integer) As String
Parâmetros
- value
- Int32
O inteiro com sinal de 32 bits a converter.The 32-bit signed integer to convert.
- toBase
- Int32
A base do valor de retorno, que deve ser 2, 8, 10 ou 16.The base of the return value, which must be 2, 8, 10, or 16.
Retornos
A representação da cadeia de caracteres de value na base toBase.The string representation of value in base toBase.
Exceções
toBase não é 2, 8, 10 ou 16.toBase is not 2, 8, 10, or 16.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiros em seu binário equivalente, hexadecimal, decimal e representações de cadeia de caracteres hexadecimal.The following example converts each element in an integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.
int[] bases = { 2, 8, 10, 16};
int[] numbers = { Int32.MinValue, -19327543, -13621, -18, 12,
19142, Int32.MaxValue };
foreach (int baseValue in bases)
{
Console.WriteLine("Base {0} conversion:", baseValue);
foreach (int number in numbers)
{
Console.WriteLine(" {0,-15} --> 0x{1}",
number, Convert.ToString(number, baseValue));
}
}
// The example displays the following output:
// Base 2 conversion:
// -2147483648 --> 0x10000000000000000000000000000000
// -19327543 --> 0x11111110110110010001010111001001
// -13621 --> 0x11111111111111111100101011001011
// -18 --> 0x11111111111111111111111111101110
// 12 --> 0x1100
// 19142 --> 0x100101011000110
// 2147483647 --> 0x1111111111111111111111111111111
// Base 8 conversion:
// -2147483648 --> 0x20000000000
// -19327543 --> 0x37666212711
// -13621 --> 0x37777745313
// -18 --> 0x37777777756
// 12 --> 0x14
// 19142 --> 0x45306
// 2147483647 --> 0x17777777777
// Base 10 conversion:
// -2147483648 --> 0x-2147483648
// -19327543 --> 0x-19327543
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 19142 --> 0x19142
// 2147483647 --> 0x2147483647
// Base 16 conversion:
// -2147483648 --> 0x80000000
// -19327543 --> 0xfed915c9
// -13621 --> 0xffffcacb
// -18 --> 0xffffffee
// 12 --> 0xc
// 19142 --> 0x4ac6
// 2147483647 --> 0x7fffffff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Integer = { Int32.MinValue, -19327543, -13621, -18, 12, _
19142, Int32.MaxValue }
For Each base As Integer In bases
Console.WriteLine("Base {0} conversion:", base)
For Each number As Integer In numbers
Console.WriteLine(" {0,-15} --> 0x{1}", _
number, Convert.ToString(number, base))
Next
Next
' The example displays the following output:
' Base 2 conversion:
' -2147483648 --> 0x10000000000000000000000000000000
' -19327543 --> 0x11111110110110010001010111001001
' -13621 --> 0x11111111111111111100101011001011
' -18 --> 0x11111111111111111111111111101110
' 12 --> 0x1100
' 19142 --> 0x100101011000110
' 2147483647 --> 0x1111111111111111111111111111111
' Base 8 conversion:
' -2147483648 --> 0x20000000000
' -19327543 --> 0x37666212711
' -13621 --> 0x37777745313
' -18 --> 0x37777777756
' 12 --> 0x14
' 19142 --> 0x45306
' 2147483647 --> 0x17777777777
' Base 10 conversion:
' -2147483648 --> 0x-2147483648
' -19327543 --> 0x-19327543
' -13621 --> 0x-13621
' -18 --> 0x-18
' 12 --> 0x12
' 19142 --> 0x19142
' 2147483647 --> 0x2147483647
' Base 16 conversion:
' -2147483648 --> 0x80000000
' -19327543 --> 0xfed915c9
' -13621 --> 0xffffcacb
' -18 --> 0xffffffee
' 12 --> 0xc
' 19142 --> 0x4ac6
' 2147483647 --> 0x7fffffff
let bases = [2; 8; 10; 16]
let numbers = [ Int32.MinValue; -19327543; -13621; -18; 12; 19142; Int32.MaxValue ]
for baseValue in bases do
printfn "Base %i conversion:" baseValue
for number in numbers do
printfn " % -15i --> 0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
// Base 2 conversion:
// -2147483648 --> 0x10000000000000000000000000000000
// -19327543 --> 0x11111110110110010001010111001001
// -13621 --> 0x11111111111111111100101011001011
// -18 --> 0x11111111111111111111111111101110
// 12 --> 0x1100
// 19142 --> 0x100101011000110
// 2147483647 --> 0x1111111111111111111111111111111
// Base 8 conversion:
// -2147483648 --> 0x20000000000
// -19327543 --> 0x37666212711
// -13621 --> 0x37777745313
// -18 --> 0x37777777756
// 12 --> 0x14
// 19142 --> 0x45306
// 2147483647 --> 0x17777777777
// Base 10 conversion:
// -2147483648 --> 0x-2147483648
// -19327543 --> 0x-19327543
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 19142 --> 0x19142
// 2147483647 --> 0x2147483647
// Base 16 conversion:
// -2147483648 --> 0x80000000
// -19327543 --> 0xfed915c9
// -13621 --> 0xffffcacb
// -18 --> 0xffffffee
// 12 --> 0xc
// 19142 --> 0x4ac6
// 2147483647 --> 0x7fffffff
Comentários
Se value for positivo e toBase for 2, 8 ou 16, a cadeia de caracteres retornada usará a representação de entrada e magnitude.If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. Se value for negativo e toBase for 2, 8 ou 16, a cadeia de caracteres retornada usará a representação complementar de duas.If value is negative and toBase is 2, 8, or 16, the returned string uses two's complement representation. Isso significa que o bit de ordem superior do byte de ordem mais alta (bit 31) é interpretado como o bit de sinal.This means that the high-order bit of the highest-order byte (bit 31) is interpreted as the sign bit. Se o ToString(Int32, Int32) método for chamado para criar uma cadeia de caracteres que posteriormente será convertida de volta em um número, um método correspondente que assume uma representação numérica semelhante deve ser chamado para executar a conversão.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. Esses métodos incluem Convert.ToInt32(String, Int32) e Int32.Parse(String, NumberStyles) .Such methods include Convert.ToInt32(String, Int32) and Int32.Parse(String, NumberStyles).
Aplica-se a
ToString(Decimal, IFormatProvider)
Converte o valor do número decimal especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::Decimal value, IFormatProvider ^ provider);
public static string ToString (decimal value, IFormatProvider provider);
public static string ToString (decimal value, IFormatProvider? provider);
static member ToString : decimal * IFormatProvider -> string
Public Shared Function ToString (value As Decimal, provider As IFormatProvider) As String
Parâmetros
- value
- Decimal
O número decimal a ser convertido.The decimal number to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de Decimal valores em sua representação de cadeia de caracteres equivalente em quatro culturas diferentes.The following example converts each element in an array of Decimal values to its equivalent string representation in four different cultures.
// Define an array of numbers to display.
decimal[] numbers = { 1734231911290.16m, -17394.32921m,
3193.23m, 98012368321.684m };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };
foreach (decimal number in numbers)
{
Console.WriteLine("{0}:", Convert.ToString(number,
System.Globalization.CultureInfo.InvariantCulture));
foreach (string cultureName in cultureNames)
{
System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
Console.WriteLine(" {0}: {1,20}",
culture.Name, Convert.ToString(number, culture));
}
Console.WriteLine();
}
// The example displays the following output:
// 1734231911290.16:
// en-US: 1734231911290.16
// fr-FR: 1734231911290,16
// ja-JP: 1734231911290.16
// ru-RU: 1734231911290,16
//
// -17394.32921:
// en-US: -17394.32921
// fr-FR: -17394,32921
// ja-JP: -17394.32921
// ru-RU: -17394,32921
//
// 3193.23:
// en-US: 3193.23
// fr-FR: 3193,23
// ja-JP: 3193.23
// ru-RU: 3193,23
//
// 98012368321.684:
// en-US: 98012368321.684
// fr-FR: 98012368321,684
// ja-JP: 98012368321.684
// ru-RU: 98012368321,684
' Define an array of numbers to display.
Dim numbers() As Decimal = { 1734231911290.16d, -17394.32921d, _
3193.23d, 98012368321.684d }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }
For Each number As Decimal In numbers
Console.WriteLine("{0}:", Convert.ToString(number, _
System.Globalization.CultureInfo.InvariantCulture))
For Each cultureName As String In cultureNames
Dim culture As New System.Globalization.CultureInfo(cultureName)
Console.WriteLine(" {0}: {1,20}", _
culture.Name, Convert.ToString(number, culture))
Next
Console.WriteLine()
Next
' The example displays the following output:
' 1734231911290.16:
' en-US: 1734231911290.16
' fr-FR: 1734231911290,16
' ja-JP: 1734231911290.16
' ru-RU: 1734231911290,16
'
' -17394.32921:
' en-US: -17394.32921
' fr-FR: -17394,32921
' ja-JP: -17394.32921
' ru-RU: -17394,32921
'
' 3193.23:
' en-US: 3193.23
' fr-FR: 3193,23
' ja-JP: 3193.23
' ru-RU: 3193,23
'
' 98012368321.684:
' en-US: 98012368321.684
' fr-FR: 98012368321,684
' ja-JP: 98012368321.684
' ru-RU: 98012368321,684
Comentários
Essa implementação é idêntica a Decimal.ToString(IFormatProvider) .This implementation is identical to Decimal.ToString(IFormatProvider).
Aplica-se a
ToString(Double, IFormatProvider)
Converte o valor do número de ponto flutuante de precisão dupla especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified double-precision floating-point number to its equivalent string representation.
public:
static System::String ^ ToString(double value, IFormatProvider ^ provider);
public static string ToString (double value, IFormatProvider provider);
public static string ToString (double value, IFormatProvider? provider);
static member ToString : double * IFormatProvider -> string
Public Shared Function ToString (value As Double, provider As IFormatProvider) As String
Parâmetros
- value
- Double
O número de ponto flutuante de precisão dupla a ser convertido.The double-precision floating-point number to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de Double valores em sua representação de cadeia de caracteres equivalente em quatro culturas diferentes.The following example converts each element in an array of Double values to its equivalent string representation in four different cultures.
// Define an array of numbers to display.
double[] numbers = { -1.5345e16, -123.4321, 19092.123, 1.1734231911290e16 };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };
foreach (double number in numbers)
{
Console.WriteLine("{0}:", Convert.ToString(number,
System.Globalization.CultureInfo.InvariantCulture));
foreach (string cultureName in cultureNames)
{
System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
Console.WriteLine(" {0}: {1,20}",
culture.Name, Convert.ToString(number, culture));
}
Console.WriteLine();
}
// The example displays the following output:
// -1.5345E+16:
// en-US: -1.5345E+16
// fr-FR: -1,5345E+16
// ja-JP: -1.5345E+16
// ru-RU: -1,5345E+16
//
// -123.4321:
// en-US: -123.4321
// fr-FR: -123,4321
// ja-JP: -123.4321
// ru-RU: -123,4321
//
// 19092.123:
// en-US: 19092.123
// fr-FR: 19092,123
// ja-JP: 19092.123
// ru-RU: 19092,123
//
// 1.173423191129E+16:
// en-US: 1.173423191129E+16
// fr-FR: 1,173423191129E+16
// ja-JP: 1.173423191129E+16
// ru-RU: 1,173423191129E+16
' Define an array of numbers to display.
Dim numbers() As Double = { -1.5345e16, -123.4321, 19092.123, _
1.1734231911290e16 }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }
For Each number As Double In numbers
Console.WriteLine("{0}:", Convert.ToString(number, _
System.Globalization.CultureInfo.InvariantCulture))
For Each cultureName As String In cultureNames
Dim culture As New System.Globalization.CultureInfo(cultureName)
Console.WriteLine(" {0}: {1,20}", _
culture.Name, Convert.ToString(number, culture))
Next
Console.WriteLine()
Next
' The example displays the following output:
' -1.5345E+16:
' en-US: -1.5345E+16
' fr-FR: -1,5345E+16
' ja-JP: -1.5345E+16
' ru-RU: -1,5345E+16
'
' -123.4321:
' en-US: -123.4321
' fr-FR: -123,4321
' ja-JP: -123.4321
' ru-RU: -123,4321
'
' 19092.123:
' en-US: 19092.123
' fr-FR: 19092,123
' ja-JP: 19092.123
' ru-RU: 19092,123
'
' 1.173423191129E+16:
' en-US: 1.173423191129E+16
' fr-FR: 1,173423191129E+16
' ja-JP: 1.173423191129E+16
' ru-RU: 1,173423191129E+16
Comentários
Essa implementação é idêntica a Double.ToString(IFormatProvider)This implementation is identical to Double.ToString(IFormatProvider)
Aplica-se a
ToString(Int16, IFormatProvider)
Converte o valor do inteiro com sinal de 16 bits especificado em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(short value, IFormatProvider ^ provider);
public static string ToString (short value, IFormatProvider provider);
public static string ToString (short value, IFormatProvider? provider);
static member ToString : int16 * IFormatProvider -> string
Public Shared Function ToString (value As Short, provider As IFormatProvider) As String
Parâmetros
- value
- Int16
O inteiro assinado de 16 bits a ser convertido.The 16-bit signed integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(Int16, IFormatProvider) método para converter cada elemento em uma matriz de inteiros de 16 bits em sua representação de cadeia de caracteres equivalente.It then calls the ToString(Int16, IFormatProvider) method to convert each element in an array of 16-bit integers to its equivalent string representation. A conversão usa a cultura invariável, bem como o objeto NumberFormatInfo personalizado.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
short[] numbers = { Int16.MinValue, Int16.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (short number in numbers)
Console.WriteLine("{0,-8} --> {1,8}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// -32768 --> ~32768
// 32767 --> 32767
Dim numbers() As Short = { Int16.MinValue, Int16.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
For Each number As Short In numbers
Console.WriteLine("{0,-8} --> {1,8}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
Next
' The example displays the following output:
' -32768 --> ~32768
' 32767 --> 32767
Comentários
Essa implementação é idêntica a Int16.ToString(IFormatProvider) .This implementation is identical to Int16.ToString(IFormatProvider).
Aplica-se a
ToString(Int16, Int32)
Converte o valor de um inteiro com sinal de 16 bits em sua representação de cadeia de caracteres equivalente em uma base especificada.Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.
public:
static System::String ^ ToString(short value, int toBase);
public static string ToString (short value, int toBase);
static member ToString : int16 * int -> string
Public Shared Function ToString (value As Short, toBase As Integer) As String
Parâmetros
- value
- Int16
O inteiro assinado de 16 bits a ser convertido.The 16-bit signed integer to convert.
- toBase
- Int32
A base do valor de retorno, que deve ser 2, 8, 10 ou 16.The base of the return value, which must be 2, 8, 10, or 16.
Retornos
A representação da cadeia de caracteres de value na base toBase.The string representation of value in base toBase.
Exceções
toBase não é 2, 8, 10 ou 16.toBase is not 2, 8, 10, or 16.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiros com sinal de 16 bits para suas representações binárias, octais, decimal e hexadecimal equivalentes.The following example converts each element in an array of 16-bit signed integers to its equivalent binary, octal, decimal, and hexadecimal string representations.
int[] bases = { 2, 8, 10, 16};
short[] numbers = { Int16.MinValue, -13621, -18, 12, 19142, Int16.MaxValue };
foreach (int baseValue in bases)
{
Console.WriteLine("Base {0} conversion:", baseValue);
foreach (short number in numbers)
{
Console.WriteLine(" {0,-8} --> 0x{1}",
number, Convert.ToString(number, baseValue));
}
}
// The example displays the following output:
// Base 2 conversion:
// -32768 --> 0x1000000000000000
// -13621 --> 0x1100101011001011
// -18 --> 0x1111111111101110
// 12 --> 0x1100
// 19142 --> 0x100101011000110
// 32767 --> 0x111111111111111
// Base 8 conversion:
// -32768 --> 0x100000
// -13621 --> 0x145313
// -18 --> 0x177756
// 12 --> 0x14
// 19142 --> 0x45306
// 32767 --> 0x77777
// Base 10 conversion:
// -32768 --> 0x-32768
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 19142 --> 0x19142
// 32767 --> 0x32767
// Base 16 conversion:
// -32768 --> 0x8000
// -13621 --> 0xcacb
// -18 --> 0xffee
// 12 --> 0xc
// 19142 --> 0x4ac6
// 32767 --> 0x7fff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Short = { Int16.MinValue, -13621, -18, 12, 19142, _
Int16.MaxValue }
For Each base As Integer In bases
Console.WriteLine("Base {0} conversion:", base)
For Each number As Short In numbers
Console.WriteLine(" {0,-8} --> 0x{1}", _
number, Convert.ToString(number, base))
Next
Next
' The example displays the following output:
' Base 2 conversion:
' -32768 --> 0x1000000000000000
' -13621 --> 0x1100101011001011
' -18 --> 0x1111111111101110
' 12 --> 0x1100
' 19142 --> 0x100101011000110
' 32767 --> 0x111111111111111
' Base 8 conversion:
' -32768 --> 0x100000
' -13621 --> 0x145313
' -18 --> 0x177756
' 12 --> 0x14
' 19142 --> 0x45306
' 32767 --> 0x77777
' Base 10 conversion:
' -32768 --> 0x-32768
' -13621 --> 0x-13621
' -18 --> 0x-18
' 12 --> 0x12
' 19142 --> 0x19142
' 32767 --> 0x32767
' Base 16 conversion:
' -32768 --> 0x8000
' -13621 --> 0xcacb
' -18 --> 0xffee
' 12 --> 0xc
' 19142 --> 0x4ac6
' 32767 --> 0x7fff
let bases = [2; 8; 10; 16]
let numbers = [ Int16.MinValue; -13621s; -18s; 12s; 19142s; Int16.MaxValue ]
for baseValue in bases do
printfn "Base %i conversion:" baseValue
for number in numbers do
printfn " % -8i --> 0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
// Base 2 conversion:
// -32768 --> 0x1000000000000000
// -13621 --> 0x1100101011001011
// -18 --> 0x1111111111101110
// 12 --> 0x1100
// 19142 --> 0x100101011000110
// 32767 --> 0x111111111111111
// Base 8 conversion:
// -32768 --> 0x100000
// -13621 --> 0x145313
// -18 --> 0x177756
// 12 --> 0x14
// 19142 --> 0x45306
// 32767 --> 0x77777
// Base 10 conversion:
// -32768 --> 0x-32768
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 19142 --> 0x19142
// 32767 --> 0x32767
// Base 16 conversion:
// -32768 --> 0x8000
// -13621 --> 0xcacb
// -18 --> 0xffee
// 12 --> 0xc
// 19142 --> 0x4ac6
// 32767 --> 0x7fff
Comentários
Se value for positivo e toBase for 2, 8 ou 16, a cadeia de caracteres retornada usará a representação de entrada e magnitude.If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. Se value for negativo e toBase for 2, 8 ou 16, a cadeia de caracteres retornada usará a representação complementar de duas.If value is negative and toBase is 2, 8, or 16, the returned string uses two's complement representation. Isso significa que o bit de ordem superior do byte de ordem superior (bit 15) é interpretado como o bit de sinal.This means that the high-order bit of the high-order byte (bit 15) is interpreted as the sign bit. Se o ToString(Int16, Int32) método for chamado para criar uma cadeia de caracteres que posteriormente será convertida de volta em um número, um método correspondente que assume uma representação numérica semelhante deve ser chamado para executar a conversão.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. Esses métodos incluem Convert.ToInt16(String, Int32) e Int16.Parse(String, NumberStyles) .Such methods include Convert.ToInt16(String, Int32) and Int16.Parse(String, NumberStyles).
Aplica-se a
ToString(Int32, IFormatProvider)
Converte o valor do inteiro com sinal de 32 bits especificado em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(int value, IFormatProvider ^ provider);
public static string ToString (int value, IFormatProvider provider);
public static string ToString (int value, IFormatProvider? provider);
static member ToString : int * IFormatProvider -> string
Public Shared Function ToString (value As Integer, provider As IFormatProvider) As String
Parâmetros
- value
- Int32
O inteiro com sinal de 32 bits a converter.The 32-bit signed integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(Int32, IFormatProvider) método para converter cada elemento em uma matriz de inteiros em sua representação de cadeia de caracteres equivalente.It then calls the ToString(Int32, IFormatProvider) method to convert each element in an array of integers to its equivalent string representation. A conversão usa a cultura invariável, bem como o objeto NumberFormatInfo personalizado.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
int[] numbers = { Int32.MinValue, Int32.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (int number in numbers)
Console.WriteLine("{0,-12} --> {1,12}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// -2147483648 --> ~2147483648
// 2147483647 --> 2147483647
Dim numbers() As Integer = { Int32.MinValue, Int32.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
For Each number As Integer In numbers
Console.WriteLine("{0,-12} --> {1,12}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
Next
' The example displays the following output:
' -2147483648 --> ~2147483648
' 2147483647 --> 2147483647
Comentários
Essa implementação é idêntica a Int32.ToString(IFormatProvider) .This implementation is identical to Int32.ToString(IFormatProvider).
Aplica-se a
ToString(Int64, IFormatProvider)
Converte o valor do inteiro com sinal de 64 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(long value, IFormatProvider ^ provider);
public static string ToString (long value, IFormatProvider provider);
public static string ToString (long value, IFormatProvider? provider);
static member ToString : int64 * IFormatProvider -> string
Public Shared Function ToString (value As Long, provider As IFormatProvider) As String
Parâmetros
- value
- Int64
O inteiro com sinal de 64 bits a ser convertido.The 64-bit signed integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(Int64, IFormatProvider) método para converter cada elemento em uma matriz de inteiro longo em sua representação de cadeia de caracteres equivalente.It then calls the ToString(Int64, IFormatProvider) method to convert each element in a long integer array to its equivalent string representation. A conversão usa a cultura invariável, bem como o objeto NumberFormatInfo personalizado.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
long[] numbers = { ((long) Int32.MinValue) * 2, ((long) Int32.MaxValue) * 2};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (long number in numbers)
Console.WriteLine("{0,-12} --> {1,12}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// -4294967296 --> ~4294967296
// 4294967294 --> 4294967294
Dim numbers() As Long = { CLng(Int32.MinValue) * 2, CLng(Int32.MaxValue) * 2 }
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
For Each number As Long In numbers
Console.WriteLine("{0,-12} --> {1,12}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
Next
' The example displays the following output:
' -4294967296 --> ~4294967296
' 4294967294 --> 4294967294
Comentários
Essa implementação é idêntica a Int64.ToString(IFormatProvider) .This implementation is identical to Int64.ToString(IFormatProvider).
Aplica-se a
ToString(UInt64)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 64 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.
public:
static System::String ^ ToString(System::UInt64 value);
[System.CLSCompliant(false)]
public static string ToString (ulong value);
[<System.CLSCompliant(false)>]
static member ToString : uint64 -> string
Public Shared Function ToString (value As ULong) As String
Parâmetros
- value
- UInt64
O inteiro sem sinal de 64 bits a ser convertido.The 64-bit unsigned integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiro longo sem sinal em sua representação de cadeia de caracteres equivalente.The following example converts each element in an unsigned long integer array to its equivalent string representation.
ulong[] numbers = { UInt64.MinValue, 1031, 189045, UInt64.MaxValue };
string result;
foreach (ulong number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the UInt64 value 0 to the String value 0.
// Converted the UInt64 value 1031 to the String value 1031.
// Converted the UInt64 value 189045 to the String value 189045.
// Converted the UInt64 value 18446744073709551615 to the String value 18446744073709551615.
Dim numbers() As ULong = { UInt64.MinValue, 1031, 189045, UInt64.MaxValue }
Dim result As String
For Each number As ULong In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the UInt64 value 0 to the String value 0.
' Converted the UInt64 value 1031 to the String value 1031.
' Converted the UInt64 value 189045 to the String value 189045.
' Converted the UInt64 value 18446744073709551615 to the String value 18446744073709551615.
Comentários
Essa implementação é idêntica a UInt64.ToString() .This implementation is identical to UInt64.ToString().
Aplica-se a
ToString(Object, IFormatProvider)
Converte o valor do objeto especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::Object ^ value, IFormatProvider ^ provider);
public static string ToString (object value, IFormatProvider provider);
public static string? ToString (object? value, IFormatProvider? provider);
static member ToString : obj * IFormatProvider -> string
Public Shared Function ToString (value As Object, provider As IFormatProvider) As String
Parâmetros
- value
- Object
Um objeto que fornece o valor a ser convertido ou null.An object that supplies the value to convert, or null.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação de cadeia de caracteres de value, ou Empty se value for um objeto cujo valor é null.The string representation of value, or Empty if value is an object whose value is null. Se value for null, o método retornará null.If value is null, the method returns null.
Exemplos
O exemplo a seguir define uma Temperature classe que substitui o Object.ToString método, mas não implementa a IConvertible interface.The following example defines a Temperature class that overrides the Object.ToString method but does not implement the IConvertible interface. O exemplo ilustra como as chamadas para o Convert.ToString(Object, IFormatProvider) método, por sua vez, chamam o Temperature.ToString método.The example illustrates how calls to the Convert.ToString(Object, IFormatProvider) method, in turn, call the Temperature.ToString method.
using System;
public class Temperature
{
private decimal m_Temp;
public Temperature(decimal temperature)
{
this.m_Temp = temperature;
}
public decimal Celsius
{
get { return this.m_Temp; }
}
public decimal Kelvin
{
get { return this.m_Temp + 273.15m; }
}
public decimal Fahrenheit
{
get { return Math.Round((decimal) (this.m_Temp * 9 / 5 + 32), 2); }
}
public override string ToString()
{
return m_Temp.ToString("N2") + " °C";
}
}
public class Example
{
public static void Main()
{
Temperature cold = new Temperature(-40);
Temperature freezing = new Temperature(0);
Temperature boiling = new Temperature(100);
Console.WriteLine(Convert.ToString(cold, null));
Console.WriteLine(Convert.ToString(freezing, null));
Console.WriteLine(Convert.ToString(boiling, null));
}
}
// The example dosplays the following output:
// -40.00 °C
// 0.00 °C
// 100.00 °C
Public Class Temperature
Private m_Temp As Decimal
Public Sub New(temperature As Decimal)
Me.m_Temp = temperature
End Sub
Public ReadOnly Property Celsius() As Decimal
Get
Return Me.m_Temp
End Get
End Property
Public ReadOnly Property Kelvin() As Decimal
Get
Return Me.m_Temp + 273.15d
End Get
End Property
Public ReadOnly Property Fahrenheit() As Decimal
Get
Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
End Get
End Property
Public Overrides Function ToString() As String
Return m_Temp.ToString("N2") & " °C"
End Function
End Class
Module Example
Public Sub Main()
Dim cold As New Temperature(-40)
Dim freezing As New Temperature(0)
Dim boiling As New Temperature(100)
Console.WriteLine(Convert.ToString(cold, Nothing))
Console.WriteLine(Convert.ToString(freezing, Nothing))
Console.WriteLine(Convert.ToString(boiling, Nothing))
End Sub
End Module
' The example displays the following output:
' -40.00 °C
' 0.00 °C
' 100.00 °C
O exemplo a seguir define uma Temperature classe que implementa a IFormattable interface, mas não implementa a IConvertible interface.The following example defines a Temperature class that implements the IFormattable interface but does not implement the IConvertible interface. Sua IFormattable.ToString implementação representa o Temperature valor em Celsius, Fahrenheit ou Kelvin, dependendo da cadeia de caracteres de formato.Its IFormattable.ToString implementation represents the Temperature value in Celsius, Fahrenheit, or Kelvin, depending on the format string. O exemplo também define uma TemperatureProvider classe que implementa IFormatProvider e fornece uma cadeia de caracteres de formato gerada aleatoriamente que é usada pela IFormattable implementação da Temperature classe.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.
using System;
public class Temperature : IFormattable
{
private decimal m_Temp;
public Temperature(decimal temperature)
{
this.m_Temp = temperature;
}
public decimal Celsius
{ get { return this.m_Temp; } }
public decimal Kelvin
{ get { return this.m_Temp + 273.15m; } }
public decimal Fahrenheit
{ get { return Math.Round(this.m_Temp * 9m / 5m + 32m, 2); } }
public override String ToString()
{
return ToString("G", null);
}
public String ToString(String fmt, IFormatProvider provider)
{
TemperatureProvider formatter = null;
if (provider != null)
formatter = provider.GetFormat(typeof(TemperatureProvider))
as TemperatureProvider;
if (String.IsNullOrWhiteSpace(fmt)) {
if (formatter != null)
fmt = formatter.Format;
else
fmt = "G";
}
switch (fmt.ToUpper()) {
case "G":
case "C":
return m_Temp.ToString("N2") + " °C";
case "F":
return Fahrenheit.ToString("N2") + " °F";
case "K":
return Kelvin.ToString("N2") + " K";
default:
throw new FormatException(String.Format("'{0}' is not a valid format specifier.", fmt));
}
}
}
public class TemperatureProvider : IFormatProvider
{
private String[] fmtStrings = { "C", "G", "F", "K" };
private Random rnd = new Random();
public Object GetFormat(Type formatType)
{
return this;
}
public String Format
{ get { return fmtStrings[rnd.Next(0, fmtStrings.Length)]; } }
}
public class Example
{
public static void Main()
{
Temperature cold = new Temperature (-40);
Temperature freezing = new Temperature (0);
Temperature boiling = new Temperature (100);
TemperatureProvider tp = new TemperatureProvider();
Console.WriteLine(Convert.ToString(cold, tp));
Console.WriteLine(Convert.ToString(freezing, tp));
Console.WriteLine(Convert.ToString(boiling, tp));
}
}
// The example displays output like the following:
// -40.00 °C
// 273.15 K
// 100.00 °C
Public Class Temperature : Implements IFormattable
Private m_Temp As Decimal
Public Sub New(temperature As Decimal)
Me.m_Temp = temperature
End Sub
Public ReadOnly Property Celsius As Decimal
Get
Return Me.m_Temp
End Get
End Property
Public ReadOnly Property Kelvin As Decimal
Get
Return Me.m_Temp + 273.15d
End Get
End Property
Public ReadOnly Property Fahrenheit As Decimal
Get
Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
End Get
End Property
Public Overrides Function ToString() As String
Return ToString("G", Nothing)
End Function
Public Overloads Function ToString(fmt As String,
provider As IFormatProvider) As String _
Implements IFormattable.ToString
Dim formatter As TemperatureProvider = Nothing
If provider IsNot Nothing Then formatter = TryCast(provider.GetFormat(GetType(TemperatureProvider)),
TemperatureProvider)
If String.IsNullOrWhiteSpace(fmt) Then
If formatter IsNot Nothing Then
fmt = formatter.Format
Else
fmt = "G"
End If
End If
Select Case fmt.ToUpper()
Case "G", "C"
Return m_Temp.ToString("N2") & " °C"
Case "F"
Return Fahrenheit.ToString("N2") + " °F"
Case "K"
Return Kelvin.ToString("N2") + " K"
Case Else
Throw New FormatException(String.Format("'{0}' is not a valid format specifier.", fmt))
End Select
End Function
End Class
Public Class TemperatureProvider : Implements IFormatProvider
Private fmtStrings() As String = { "C", "G", "F", "K" }
Private rnd As New Random()
Public Function GetFormat(formatType As Type) As Object _
Implements IFormatProvider.GetFormat
Return Me
End Function
Public ReadOnly Property Format As String
Get
Return fmtStrings(rnd.Next(0, fmtStrings.Length))
End Get
End Property
End Class
Module Example
Public Sub Main()
Dim cold As New Temperature(-40)
Dim freezing As New Temperature(0)
Dim boiling As New Temperature(100)
Dim tp As New TemperatureProvider()
Console.WriteLine(Convert.ToString(cold, tp))
Console.WriteLine(Convert.ToString(freezing, tp))
Console.WriteLine(Convert.ToString(boiling, tp))
End Sub
End Module
' The example displays output like the following:
' -40.00 °C
' 273.15 K
' 100.00 °C
Comentários
Se o value parâmetro implementar a IConvertible interface, o método chamará a IConvertible.ToString(IFormatProvider) implementação de value .If the value parameter implements the IConvertible interface, the method calls the IConvertible.ToString(IFormatProvider) implementation of value. Caso contrário, se o value parâmetro implementar a IFormattable interface, o método chamará sua IFormattable.ToString(String, IFormatProvider) implementação.Otherwise, if the value parameter implements the IFormattable interface, the method calls its IFormattable.ToString(String, IFormatProvider) implementation. Se o value implementar nenhuma interface, o método chamará o value método do parâmetro ToString() e o provider parâmetro será ignorado.If value implements neither interface, the method calls the value parameter's ToString() method, and the provider parameter is ignored.
O provider parâmetro será usado se o value parâmetro implementar a IConvertible IFormattable interface ou.The provider parameter is used if the value parameter implements the IConvertible or IFormattable interface. O uso mais comum do provider parâmetro é especificar informações específicas de cultura usadas na conversão de value .The most common use of the provider parameter is to specify culture-specific information used in the conversion of value. Por exemplo, se o value parâmetro for um número decimal negativo, o provider parâmetro poderá fornecer informações específicas de cultura sobre a notação usada para o sinal negativo e o separador decimal.For example, if the value parameter is a negative decimal number, the provider parameter can supply culture-specific information about the notation used for the negative sign and decimal separator. O segundo exemplo na próxima seção ilustra um provedor de formato que não fornece informações de formatação sensíveis à cultura.The second example in the next section illustrates a format provider that does not supply culture-sensitive formatting information.
Aplica-se a
ToString(SByte, IFormatProvider)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro com sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::SByte value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member ToString : sbyte * IFormatProvider -> string
Public Shared Function ToString (value As SByte, provider As IFormatProvider) As String
Parâmetros
- value
- SByte
O inteiro com sinal de 8 bits a ser convertido.The 8-bit signed integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o Convert.ToString(SByte, IFormatProvider) método para converter cada elemento na matriz de bytes assinada em sua representação de cadeia de caracteres equivalente.It then calls the Convert.ToString(SByte, IFormatProvider) method to convert each element in signed byte array to its equivalent string representation. A conversão usa a cultura invariável, bem como o objeto NumberFormatInfo personalizado.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.
sbyte[] numbers = { SByte.MinValue, -12, 17, SByte.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (sbyte number in numbers)
Console.WriteLine(Convert.ToString(number, nfi));
// The example displays the following output:
// ~128
// ~12
// 17
// 127
Dim numbers() As SByte = { SByte.MinValue, -12, 17, SByte.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
For Each number As SByte In numbers
Console.WriteLine(Convert.ToString(number, nfi))
Next
' The example displays the following output:
' ~128
' ~12
' 17
' 127
Comentários
Essa implementação é idêntica a SByte.ToString(IFormatProvider) .This implementation is identical to SByte.ToString(IFormatProvider).
Aplica-se a
ToString(Single, IFormatProvider)
Converte o valor do número de ponto flutuante de precisão simples em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura.Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(float value, IFormatProvider ^ provider);
public static string ToString (float value, IFormatProvider provider);
public static string ToString (float value, IFormatProvider? provider);
static member ToString : single * IFormatProvider -> string
Public Shared Function ToString (value As Single, provider As IFormatProvider) As String
Parâmetros
- value
- Single
O número de ponto flutuante de precisão simples a ser convertido.The single-precision floating-point number to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de Single valores em sua representação de cadeia de caracteres equivalente em quatro culturas diferentes.The following example converts each element in an array of Single values to its equivalent string representation in four different cultures.
// Define an array of numbers to display.
float[] numbers = { -1.5345e16f, -123.4321f, 19092.123f, 1.1734231911290e16f };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };
foreach (float number in numbers)
{
Console.WriteLine("{0}:", Convert.ToString(number,
System.Globalization.CultureInfo.InvariantCulture));
foreach (string cultureName in cultureNames)
{
System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
Console.WriteLine(" {0}: {1,20}",
culture.Name, Convert.ToString(number, culture));
}
Console.WriteLine();
}
// The example displays the following output:
// -1.5345E+16:
// en-US: -1.5345E+16
// fr-FR: -1,5345E+16
// ja-JP: -1.5345E+16
// ru-RU: -1,5345E+16
//
// -123.4321:
// en-US: -123.4321
// fr-FR: -123,4321
// ja-JP: -123.4321
// ru-RU: -123,4321
//
// 19092.123:
// en-US: 19092.123
// fr-FR: 19092,123
// ja-JP: 19092.123
// ru-RU: 19092,123
//
// 1.173423191129E+16:
// en-US: 1.173423191129E+16
// fr-FR: 1,173423191129E+16
// ja-JP: 1.173423191129E+16
// ru-RU: 1,173423191129E+16
' Define an array of numbers to display.
Dim numbers() As Single = { -1.5345e16, -123.4321, 19092.123, _
1.1734231911290e16 }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }
For Each number As Single In numbers
Console.WriteLine("{0}:", Convert.ToString(number, _
System.Globalization.CultureInfo.InvariantCulture))
For Each cultureName As String In cultureNames
Dim culture As New System.Globalization.CultureInfo(cultureName)
Console.WriteLine(" {0}: {1,20}", _
culture.Name, Convert.ToString(number, culture))
Next
Console.WriteLine()
Next
' The example displays the following output:
' -1.5345E+16:
' en-US: -1.5345E+16
' fr-FR: -1,5345E+16
' ja-JP: -1.5345E+16
' ru-RU: -1,5345E+16
'
' -123.4321:
' en-US: -123.4321
' fr-FR: -123,4321
' ja-JP: -123.4321
' ru-RU: -123,4321
'
' 19092.123:
' en-US: 19092.123
' fr-FR: 19092,123
' ja-JP: 19092.123
' ru-RU: 19092,123
'
' 1.173423191129E+16:
' en-US: 1.173423191129E+16
' fr-FR: 1,173423191129E+16
' ja-JP: 1.173423191129E+16
' ru-RU: 1,173423191129E+16
Comentários
Essa implementação é idêntica a Single.ToString(IFormatProvider) .This implementation is identical to Single.ToString(IFormatProvider).
Aplica-se a
ToString(String, IFormatProvider)
Retorna a instância de cadeia de caracteres especificada; nenhuma conversão real é executada.Returns the specified string instance; no actual conversion is performed.
public:
static System::String ^ ToString(System::String ^ value, IFormatProvider ^ provider);
public static string? ToString (string? value, IFormatProvider? provider);
public static string ToString (string value, IFormatProvider provider);
static member ToString : string * IFormatProvider -> string
Public Shared Function ToString (value As String, provider As IFormatProvider) As String
Parâmetros
- value
- String
A cadeia de caracteres a ser retornada.The string to return.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information. Este parâmetro é ignorado.This parameter is ignored.
Retornos
value é retornado inalterado.value is returned unchanged.
Exemplos
O exemplo a seguir chama o ToString método com um String parâmetro.The following example calls the ToString method with a String parameter. O método retorna o não modificado String sem fazer referência ao IFormatProvider objeto.The method returns the unmodified String without referencing the IFormatProvider object.
// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;
#define null (Object^)0
// An instance of this class can be passed to methods that require
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
virtual Object^ GetFormat( Type^ argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console::Write( "{0,-40}", argType->ToString() );
return null;
}
};
int main()
{
// Create an instance of the IFormatProvider.
DummyProvider^ provider = gcnew DummyProvider;
String^ converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
Object^ ObjDouble = -98765.4321;
DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
bool BoolA = true;
String^ StringA = "Qwerty";
Char CharA = '$';
TimeSpan TSpanA = TimeSpan(0,18,0);
Object^ ObjOther = static_cast<Object^>(provider);
Console::WriteLine( "This example of "
"Convert::ToString( non-numeric, IFormatProvider* ) \n"
"generates the following output. The provider type, "
"argument type, \nand argument value are displayed." );
Console::WriteLine( "\nNote: The IFormatProvider object is "
"not called for Boolean, String, \nChar, TimeSpan, "
"and non-numeric Object." );
// The format provider is called for these conversions.
Console::WriteLine();
converted = Convert::ToString( Int32A, provider );
Console::WriteLine( "int {0}", converted );
converted = Convert::ToString( DoubleA, provider );
Console::WriteLine( "double {0}", converted );
converted = Convert::ToString( ObjDouble, provider );
Console::WriteLine( "Object {0}", converted );
converted = Convert::ToString( DayTimeA, provider );
Console::WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console::WriteLine();
converted = Convert::ToString( BoolA, provider );
Console::WriteLine( "bool {0}", converted );
converted = Convert::ToString( StringA, provider );
Console::WriteLine( "String {0}", converted );
converted = Convert::ToString( CharA, provider );
Console::WriteLine( "Char {0}", converted );
converted = Convert::ToString( TSpanA, provider );
Console::WriteLine( "TimeSpan {0}", converted );
converted = Convert::ToString( ObjOther, provider );
Console::WriteLine( "Object {0}", converted );
}
/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo Object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
String Qwerty
Char $
TimeSpan 00:18:00
Object DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;
// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
public object GetFormat( Type argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) );
return null;
}
}
class ConvertNonNumericProviderDemo
{
static void Main( )
{
// Create an instance of the IFormatProvider.
DummyProvider provider = new DummyProvider( );
string converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
object ObjDouble = (object)( -98765.4321 );
DateTime DayTimeA = new DateTime( 2001, 9, 11, 13, 45, 0 );
bool BoolA = true;
string StringA = "Qwerty";
char CharA = '$';
TimeSpan TSpanA = new TimeSpan( 0, 18, 0 );
object ObjOther = (object)provider;
Console.WriteLine( "This example of " +
"Convert.ToString( non-numeric, IFormatProvider ) \n" +
"generates the following output. The provider type, " +
"argument type, \nand argument value are displayed." );
Console.WriteLine( "\nNote: The IFormatProvider object is " +
"not called for Boolean, String, \nChar, TimeSpan, " +
"and non-numeric Object." );
// The format provider is called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( Int32A, provider );
Console.WriteLine( "int {0}", converted );
converted = Convert.ToString( DoubleA, provider );
Console.WriteLine( "double {0}", converted );
converted = Convert.ToString( ObjDouble, provider );
Console.WriteLine( "object {0}", converted );
converted = Convert.ToString( DayTimeA, provider );
Console.WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( BoolA, provider );
Console.WriteLine( "bool {0}", converted );
converted = Convert.ToString( StringA, provider );
Console.WriteLine( "string {0}", converted );
converted = Convert.ToString( CharA, provider );
Console.WriteLine( "char {0}", converted );
converted = Convert.ToString( TSpanA, provider );
Console.WriteLine( "TimeSpan {0}", converted );
converted = Convert.ToString( ObjOther, provider );
Console.WriteLine( "object {0}", converted );
}
}
/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
string Qwerty
char $
TimeSpan 00:18:00
object DummyProvider
*/
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization
' An instance of this class can be passed to methods that require
' an IFormatProvider.
Public Class DummyProvider
Implements IFormatProvider
' Normally, GetFormat returns an object of the requested type
' (usually itself) if it is able; otherwise, it returns Nothing.
Public Function GetFormat( argType As Type ) As Object _
Implements IFormatProvider.GetFormat
' Here, the type of argType is displayed, and GetFormat
' always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) )
Return Nothing
End Function
End Class
Module ConvertNonNumericProviderDemo
Sub Main( )
' Create an instance of the IFormatProvider.
Dim provider As New DummyProvider( )
Dim converted As String
' Convert these values using DummyProvider.
Dim Int32A As Integer = -252645135
Dim DoubleA As Double = 61680.3855
Dim ObjDouble As Object = CType( -98765.4321, Object )
Dim DayTimeA As DateTime = _
new DateTime( 2001, 9, 11, 13, 45, 0 )
Dim BoolA As Boolean = True
Dim StringA As String = "Qwerty"
Dim CharA As Char = "$"c
Dim TSpanA As TimeSpan = New TimeSpan( 0, 18, 0 )
Dim ObjOther As Object = CType( provider, Object )
Console.WriteLine( "This example of " & _
"Convert.ToString( non-numeric, IFormatProvider ) " & _
vbCrLf & "generates the following output. The " & _
"provider type, argument type, " & vbCrLf & "and " & _
"argument value are displayed." )
Console.WriteLine( vbCrLf & _
"Note: The IFormatProvider object is not called for " & _
"Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
"and non-numeric Object." )
' The format provider is called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( Int32A, provider )
Console.WriteLine( "Int32 {0}", converted )
converted = Convert.ToString( DoubleA, provider )
Console.WriteLine( "Double {0}", converted )
converted = Convert.ToString( ObjDouble, provider )
Console.WriteLine( "Object {0}", converted )
converted = Convert.ToString( DayTimeA, provider )
Console.WriteLine( "DateTime {0}", converted )
' The format provider is not called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( BoolA, provider )
Console.WriteLine( "Boolean {0}", converted )
converted = Convert.ToString( StringA, provider )
Console.WriteLine( "String {0}", converted )
converted = Convert.ToString( CharA, provider )
Console.WriteLine( "Char {0}", converted )
converted = Convert.ToString( TSpanA, provider )
Console.WriteLine( "TimeSpan {0}", converted )
converted = Convert.ToString( ObjOther, provider )
Console.WriteLine( "Object {0}", converted )
End Sub
End Module
' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
'
' System.Globalization.NumberFormatInfo Int32 -252645135
' System.Globalization.NumberFormatInfo Double 61680.3855
' System.Globalization.NumberFormatInfo Object -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
'
' Boolean True
' String Qwerty
' Char $
' TimeSpan 00:18:00
' Object DummyProvider
Aplica-se a
ToString(UInt16, IFormatProvider)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 16 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::UInt16 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member ToString : uint16 * IFormatProvider -> string
Public Shared Function ToString (value As UShort, provider As IFormatProvider) As String
Parâmetros
- value
- UInt16
O inteiro não assinado de 16 bits a ser convertido.The 16-bit unsigned integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(UInt16, IFormatProvider) método para converter um valor inteiro sem sinal de 16 bits em sua representação de cadeia de caracteres equivalente.It then calls the ToString(UInt16, IFormatProvider) method to convert a 16-bit unsigned integer value to its equivalent string representation. A conversão usa a cultura invariável e o NumberFormatInfo objeto personalizado.The conversion uses both the invariant culture and the custom NumberFormatInfo object. A saída indica que essas informações de formatação não são usadas porque, por padrão, o especificador de formato "G" não inclui um sinal positivo com valores positivos.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.
ushort number = UInt16.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
Console.WriteLine("{0,-6} --> {1,6}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// 65535 --> 65535
Dim number As UShort = UInt16.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
Console.WriteLine("{0,-6} --> {1,6}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
' The example displays the following output:
' 65535 --> 65535
Comentários
Essa implementação é idêntica a UInt16.ToString(IFormatProvider) .This implementation is identical to UInt16.ToString(IFormatProvider).
Aplica-se a
ToString(UInt32, IFormatProvider)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 32 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::UInt32 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member ToString : uint32 * IFormatProvider -> string
Public Shared Function ToString (value As UInteger, provider As IFormatProvider) As String
Parâmetros
- value
- UInt32
O inteiro sem sinal de 32 bits a ser convertido.The 32-bit unsigned integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(UInt32, IFormatProvider) método para converter um valor inteiro não assinado em sua representação de cadeia de caracteres equivalente.It then calls the ToString(UInt32, IFormatProvider) method to convert an unsigned integer value to its equivalent string representation. A conversão usa a cultura invariável e o NumberFormatInfo objeto personalizado.The conversion uses both the invariant culture and the custom NumberFormatInfo object. A saída indica que essas informações de formatação não são usadas porque, por padrão, o especificador de formato "G" não inclui um sinal positivo com valores positivos.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.
uint number = UInt32.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
Console.WriteLine("{0,-8} --> {1,8}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// 4294967295 --> 4294967295
Dim number As UInteger = UInt32.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
Console.WriteLine("{0,-8} --> {1,8}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
' The example displays the following output:
' 4294967295 --> 4294967295
Comentários
Essa implementação é idêntica a UInt32.ToString(IFormatProvider) .This implementation is identical to UInt32.ToString(IFormatProvider).
Aplica-se a
ToString(UInt64, IFormatProvider)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 64 bits especificado na representação de cadeia de caracteres equivalente, usando as informações de formatação específicas à cultura especificadas.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::UInt64 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member ToString : uint64 * IFormatProvider -> string
Public Shared Function ToString (value As ULong, provider As IFormatProvider) As String
Parâmetros
- value
- UInt64
O inteiro sem sinal de 64 bits a ser convertido.The 64-bit unsigned integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir define uma classe NumberFormatInfo personalizada que define o sinal de subtração como a cadeia de caracteres "~" e o sinal de adição como a cadeia de caracteres "!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". Em seguida, ele chama o ToString(UInt64, IFormatProvider) método para converter um valor inteiro longo sem sinal em sua representação de cadeia de caracteres equivalente.It then calls the ToString(UInt64, IFormatProvider) method to convert an unsigned long integer value to its equivalent string representation. A conversão usa a cultura invariável e o NumberFormatInfo objeto personalizado.The conversion uses both the invariant culture and the custom NumberFormatInfo object. A saída indica que essas informações de formatação não são usadas porque, por padrão, o especificador de formato "G" não inclui um sinal positivo com valores positivos.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.
ulong number = UInt64.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
Console.WriteLine("{0,-12} --> {1,12}",
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
Convert.ToString(number, nfi));
// The example displays the following output:
// 18446744073709551615 --> 18446744073709551615
Dim number As ULong = UInt64.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
Console.WriteLine("{0,-12} --> {1,12}", _
Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
Convert.ToString(number, nfi))
' The example displays the following output:
' 18446744073709551615 --> 18446744073709551615
Comentários
Essa implementação é idêntica a UInt64.ToString(IFormatProvider) .This implementation is identical to UInt64.ToString(IFormatProvider).
Aplica-se a
ToString(DateTime, IFormatProvider)
Converte o valor do DateTime especificado na representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura determinadas.Converts the value of the specified DateTime to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(DateTime value, IFormatProvider ^ provider);
public static string ToString (DateTime value, IFormatProvider provider);
public static string ToString (DateTime value, IFormatProvider? provider);
static member ToString : DateTime * IFormatProvider -> string
Public Shared Function ToString (value As DateTime, provider As IFormatProvider) As String
Parâmetros
- value
- DateTime
O valor de data e tempo a ser convertido.The date and time value to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um DateTime valor em sua representação de cadeia de caracteres equivalente em oito culturas diferentes.The following example converts a DateTime value to its equivalent string representation in eight different cultures.
// Specify the date to be formatted using various cultures.
DateTime tDate = new DateTime(2010, 4, 15, 20, 30, 40, 333);
// Specify the cultures.
string[] cultureNames = { "en-US", "es-AR", "fr-FR", "hi-IN",
"ja-JP", "nl-NL", "ru-RU", "ur-PK" };
Console.WriteLine("Converting the date {0}: ",
Convert.ToString(tDate,
System.Globalization.CultureInfo.InvariantCulture));
foreach (string cultureName in cultureNames)
{
System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
string dateString = Convert.ToString(tDate, culture);
Console.WriteLine(" {0}: {1,-12}",
culture.Name, dateString);
}
// The example displays the following output:
// Converting the date 04/15/2010 20:30:40:
// en-US: 4/15/2010 8:30:40 PM
// es-AR: 15/04/2010 08:30:40 p.m.
// fr-FR: 15/04/2010 20:30:40
// hi-IN: 15-04-2010 20:30:40
// ja-JP: 2010/04/15 20:30:40
// nl-NL: 15-4-2010 20:30:40
// ru-RU: 15.04.2010 20:30:40
// ur-PK: 15/04/2010 8:30:40 PM
' Specify the date to be formatted using various cultures.
Dim tDate As New Date(2010, 4, 15, 20, 30, 40, 333)
' Specify the cultures.
Dim cultureNames() As String = { "en-US", "es-AR", "fr-FR", "hi-IN", _
"ja-JP", "nl-NL", "ru-RU", "ur-PK" }
Console.WriteLine("Converting the date {0}: ", _
Convert.ToString(tDate, _
System.Globalization.CultureInfo.InvariantCulture))
For Each cultureName As String In CultureNames
Dim culture As New System.Globalization.CultureInfo(cultureName)
Dim dateString As String = Convert.ToString(tDate, culture)
Console.WriteLine(" {0}: {1,-12}", _
culture.Name, dateString)
Next
' The example displays the following output:
' Converting the date 04/15/2010 20:30:40:
' en-US: 4/15/2010 8:30:40 PM
' es-AR: 15/04/2010 08:30:40 p.m.
' fr-FR: 15/04/2010 20:30:40
' hi-IN: 15-04-2010 20:30:40
' ja-JP: 2010/04/15 20:30:40
' nl-NL: 15-4-2010 20:30:40
' ru-RU: 15.04.2010 20:30:40
' ur-PK: 15/04/2010 8:30:40 PM
Comentários
Essa implementação é idêntica a DateTime.ToString(IFormatProvider) .This implementation is identical to DateTime.ToString(IFormatProvider).
Aplica-se a
ToString(Int64, Int32)
Converte o valor de um inteiro com sinal de 64 bits na representação de cadeia de caracteres equivalente a ele em uma base especificada.Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.
public:
static System::String ^ ToString(long value, int toBase);
public static string ToString (long value, int toBase);
static member ToString : int64 * int -> string
Public Shared Function ToString (value As Long, toBase As Integer) As String
Parâmetros
- value
- Int64
O inteiro com sinal de 64 bits a ser convertido.The 64-bit signed integer to convert.
- toBase
- Int32
A base do valor de retorno, que deve ser 2, 8, 10 ou 16.The base of the return value, which must be 2, 8, 10, or 16.
Retornos
A representação da cadeia de caracteres de value na base toBase.The string representation of value in base toBase.
Exceções
toBase não é 2, 8, 10 ou 16.toBase is not 2, 8, 10, or 16.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiros longa para suas representações binárias, hexadecimais, decimais e hexadecimais equivalentes.The following example converts each element in a long integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.
int[] bases = { 2, 8, 10, 16};
long[] numbers = { Int64.MinValue, -193275430, -13621, -18, 12,
1914206117, Int64.MaxValue };
foreach (int baseValue in bases)
{
Console.WriteLine("Base {0} conversion:", baseValue);
foreach (long number in numbers)
{
Console.WriteLine(" {0,-23} --> 0x{1}",
number, Convert.ToString(number, baseValue));
}
}
// The example displays the following output:
// Base 2 conversion:
// -9223372036854775808 --> 0x1000000000000000000000000000000000000000000000000000000000000000
// -193275430 --> 0x1111111111111111111111111111111111110100011110101101100111011010
// -13621 --> 0x1111111111111111111111111111111111111111111111111100101011001011
// -18 --> 0x1111111111111111111111111111111111111111111111111111111111101110
// 12 --> 0x1100
// 1914206117 --> 0x1110010000110000111011110100101
// 9223372036854775807 --> 0x111111111111111111111111111111111111111111111111111111111111111
// Base 8 conversion:
// -9223372036854775808 --> 0x1000000000000000000000
// -193275430 --> 0x1777777777776436554732
// -13621 --> 0x1777777777777777745313
// -18 --> 0x1777777777777777777756
// 12 --> 0x14
// 1914206117 --> 0x16206073645
// 9223372036854775807 --> 0x777777777777777777777
// Base 10 conversion:
// -9223372036854775808 --> 0x-9223372036854775808
// -193275430 --> 0x-193275430
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 1914206117 --> 0x1914206117
// 9223372036854775807 --> 0x9223372036854775807
// Base 16 conversion:
// -9223372036854775808 --> 0x8000000000000000
// -193275430 --> 0xfffffffff47ad9da
// -13621 --> 0xffffffffffffcacb
// -18 --> 0xffffffffffffffee
// 12 --> 0xc
// 1914206117 --> 0x721877a5
// 9223372036854775807 --> 0x7fffffffffffffff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Long = { Int64.MinValue, -193275430, -13621, -18, 12, _
1914206117, Int64.MaxValue }
For Each base As Integer In bases
Console.WriteLine("Base {0} conversion:", base)
For Each number As Long In numbers
Console.WriteLine(" {0,-23} --> 0x{1}", _
number, Convert.ToString(number, base))
Next
Next
' The example displays the following output:
' Base 2 conversion:
' -9223372036854775808 --> 0x1000000000000000000000000000000000000000000000000000000000000000
' -193275430 --> 0x1111111111111111111111111111111111110100011110101101100111011010
' -13621 --> 0x1111111111111111111111111111111111111111111111111100101011001011
' -18 --> 0x1111111111111111111111111111111111111111111111111111111111101110
' 12 --> 0x1100
' 1914206117 --> 0x1110010000110000111011110100101
' 9223372036854775807 --> 0x111111111111111111111111111111111111111111111111111111111111111
' Base 8 conversion:
' -9223372036854775808 --> 0x1000000000000000000000
' -193275430 --> 0x1777777777776436554732
' -13621 --> 0x1777777777777777745313
' -18 --> 0x1777777777777777777756
' 12 --> 0x14
' 1914206117 --> 0x16206073645
' 9223372036854775807 --> 0x777777777777777777777
' Base 10 conversion:
' -9223372036854775808 --> 0x-9223372036854775808
' -193275430 --> 0x-193275430
' -13621 --> 0x-13621
' -18 --> 0x-18
' 12 --> 0x12
' 1914206117 --> 0x1914206117
' 9223372036854775807 --> 0x9223372036854775807
' Base 16 conversion:
' -9223372036854775808 --> 0x8000000000000000
' -193275430 --> 0xfffffffff47ad9da
' -13621 --> 0xffffffffffffcacb
' -18 --> 0xffffffffffffffee
' 12 --> 0xc
' 1914206117 --> 0x721877a5
' 9223372036854775807 --> 0x7fffffffffffffff
let bases = [2; 8; 10; 16]
let numbers = [ Int64.MinValue; -193275430L; -13621L; -18L; 12L; 1914206117L; Int64.MaxValue ]
for baseValue in bases do
printfn "Base %i conversion:" baseValue
for number in numbers do
printfn " % -23i --> 0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
// Base 2 conversion:
// -9223372036854775808 --> 0x1000000000000000000000000000000000000000000000000000000000000000
// -193275430 --> 0x1111111111111111111111111111111111110100011110101101100111011010
// -13621 --> 0x1111111111111111111111111111111111111111111111111100101011001011
// -18 --> 0x1111111111111111111111111111111111111111111111111111111111101110
// 12 --> 0x1100
// 1914206117 --> 0x1110010000110000111011110100101
// 9223372036854775807 --> 0x111111111111111111111111111111111111111111111111111111111111111
// Base 8 conversion:
// -9223372036854775808 --> 0x1000000000000000000000
// -193275430 --> 0x1777777777776436554732
// -13621 --> 0x1777777777777777745313
// -18 --> 0x1777777777777777777756
// 12 --> 0x14
// 1914206117 --> 0x16206073645
// 9223372036854775807 --> 0x777777777777777777777
// Base 10 conversion:
// -9223372036854775808 --> 0x-9223372036854775808
// -193275430 --> 0x-193275430
// -13621 --> 0x-13621
// -18 --> 0x-18
// 12 --> 0x12
// 1914206117 --> 0x1914206117
// 9223372036854775807 --> 0x9223372036854775807
// Base 16 conversion:
// -9223372036854775808 --> 0x8000000000000000
// -193275430 --> 0xfffffffff47ad9da
// -13621 --> 0xffffffffffffcacb
// -18 --> 0xffffffffffffffee
// 12 --> 0xc
// 1914206117 --> 0x721877a5
// 9223372036854775807 --> 0x7fffffffffffffff
Comentários
Se value for positivo e toBase não for 10, a cadeia de caracteres retornada usará a representação de entrada e magnitude.If value is positive and toBase is not 10, the returned string uses sign-and-magnitude representation. Se value for negativo e toBase não for 10, a cadeia de caracteres retornada usará a representação complementar de duas.If value is negative and toBase is not 10, the returned string uses two's complement representation. Isso significa que o bit de ordem superior do byte de ordem mais alta (bit 63) é interpretado como o bit de sinal.This means that the high-order bit of the highest-order byte (bit 63) is interpreted as the sign bit. Se o ToString(Int64, Int32) método for chamado para criar uma cadeia de caracteres que posteriormente será convertida de volta em um número, um método correspondente que assume uma representação numérica semelhante deve ser chamado para executar a conversão.If the ToString(Int64, 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. Esses métodos incluem Convert.ToInt64(String, Int32) e Int64.Parse(String, NumberStyles) .Such methods include Convert.ToInt64(String, Int32) and Int64.Parse(String, NumberStyles).
Aplica-se a
ToString(Char, IFormatProvider)
Converte o valor do caractere Unicode especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(char value, IFormatProvider ^ provider);
public static string ToString (char value, IFormatProvider provider);
public static string ToString (char value, IFormatProvider? provider);
static member ToString : char * IFormatProvider -> string
Public Shared Function ToString (value As Char, provider As IFormatProvider) As String
Parâmetros
- value
- Char
O caractere Unicode a ser convertido.The Unicode character to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information. Este parâmetro é ignorado.This parameter is ignored.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um Char valor em um String com o ToString método, usando um IFormatProvider objeto que exibe o tipo do provedor de formato para o qual ele é chamado.The following example converts a Char value to a String with the ToString method, using an IFormatProvider object that displays the type of the format provider for which it is called. O exemplo mostra que o IFormatProvider objeto não é referenciado.The example shows that the IFormatProvider object is not referenced.
// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;
#define null (Object^)0
// An instance of this class can be passed to methods that require
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
virtual Object^ GetFormat( Type^ argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console::Write( "{0,-40}", argType->ToString() );
return null;
}
};
int main()
{
// Create an instance of the IFormatProvider.
DummyProvider^ provider = gcnew DummyProvider;
String^ converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
Object^ ObjDouble = -98765.4321;
DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
bool BoolA = true;
String^ StringA = "Qwerty";
Char CharA = '$';
TimeSpan TSpanA = TimeSpan(0,18,0);
Object^ ObjOther = static_cast<Object^>(provider);
Console::WriteLine( "This example of "
"Convert::ToString( non-numeric, IFormatProvider* ) \n"
"generates the following output. The provider type, "
"argument type, \nand argument value are displayed." );
Console::WriteLine( "\nNote: The IFormatProvider object is "
"not called for Boolean, String, \nChar, TimeSpan, "
"and non-numeric Object." );
// The format provider is called for these conversions.
Console::WriteLine();
converted = Convert::ToString( Int32A, provider );
Console::WriteLine( "int {0}", converted );
converted = Convert::ToString( DoubleA, provider );
Console::WriteLine( "double {0}", converted );
converted = Convert::ToString( ObjDouble, provider );
Console::WriteLine( "Object {0}", converted );
converted = Convert::ToString( DayTimeA, provider );
Console::WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console::WriteLine();
converted = Convert::ToString( BoolA, provider );
Console::WriteLine( "bool {0}", converted );
converted = Convert::ToString( StringA, provider );
Console::WriteLine( "String {0}", converted );
converted = Convert::ToString( CharA, provider );
Console::WriteLine( "Char {0}", converted );
converted = Convert::ToString( TSpanA, provider );
Console::WriteLine( "TimeSpan {0}", converted );
converted = Convert::ToString( ObjOther, provider );
Console::WriteLine( "Object {0}", converted );
}
/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo Object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
String Qwerty
Char $
TimeSpan 00:18:00
Object DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;
// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
public object GetFormat( Type argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) );
return null;
}
}
class ConvertNonNumericProviderDemo
{
static void Main( )
{
// Create an instance of the IFormatProvider.
DummyProvider provider = new DummyProvider( );
string converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
object ObjDouble = (object)( -98765.4321 );
DateTime DayTimeA = new DateTime( 2001, 9, 11, 13, 45, 0 );
bool BoolA = true;
string StringA = "Qwerty";
char CharA = '$';
TimeSpan TSpanA = new TimeSpan( 0, 18, 0 );
object ObjOther = (object)provider;
Console.WriteLine( "This example of " +
"Convert.ToString( non-numeric, IFormatProvider ) \n" +
"generates the following output. The provider type, " +
"argument type, \nand argument value are displayed." );
Console.WriteLine( "\nNote: The IFormatProvider object is " +
"not called for Boolean, String, \nChar, TimeSpan, " +
"and non-numeric Object." );
// The format provider is called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( Int32A, provider );
Console.WriteLine( "int {0}", converted );
converted = Convert.ToString( DoubleA, provider );
Console.WriteLine( "double {0}", converted );
converted = Convert.ToString( ObjDouble, provider );
Console.WriteLine( "object {0}", converted );
converted = Convert.ToString( DayTimeA, provider );
Console.WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( BoolA, provider );
Console.WriteLine( "bool {0}", converted );
converted = Convert.ToString( StringA, provider );
Console.WriteLine( "string {0}", converted );
converted = Convert.ToString( CharA, provider );
Console.WriteLine( "char {0}", converted );
converted = Convert.ToString( TSpanA, provider );
Console.WriteLine( "TimeSpan {0}", converted );
converted = Convert.ToString( ObjOther, provider );
Console.WriteLine( "object {0}", converted );
}
}
/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
string Qwerty
char $
TimeSpan 00:18:00
object DummyProvider
*/
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization
' An instance of this class can be passed to methods that require
' an IFormatProvider.
Public Class DummyProvider
Implements IFormatProvider
' Normally, GetFormat returns an object of the requested type
' (usually itself) if it is able; otherwise, it returns Nothing.
Public Function GetFormat( argType As Type ) As Object _
Implements IFormatProvider.GetFormat
' Here, the type of argType is displayed, and GetFormat
' always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) )
Return Nothing
End Function
End Class
Module ConvertNonNumericProviderDemo
Sub Main( )
' Create an instance of the IFormatProvider.
Dim provider As New DummyProvider( )
Dim converted As String
' Convert these values using DummyProvider.
Dim Int32A As Integer = -252645135
Dim DoubleA As Double = 61680.3855
Dim ObjDouble As Object = CType( -98765.4321, Object )
Dim DayTimeA As DateTime = _
new DateTime( 2001, 9, 11, 13, 45, 0 )
Dim BoolA As Boolean = True
Dim StringA As String = "Qwerty"
Dim CharA As Char = "$"c
Dim TSpanA As TimeSpan = New TimeSpan( 0, 18, 0 )
Dim ObjOther As Object = CType( provider, Object )
Console.WriteLine( "This example of " & _
"Convert.ToString( non-numeric, IFormatProvider ) " & _
vbCrLf & "generates the following output. The " & _
"provider type, argument type, " & vbCrLf & "and " & _
"argument value are displayed." )
Console.WriteLine( vbCrLf & _
"Note: The IFormatProvider object is not called for " & _
"Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
"and non-numeric Object." )
' The format provider is called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( Int32A, provider )
Console.WriteLine( "Int32 {0}", converted )
converted = Convert.ToString( DoubleA, provider )
Console.WriteLine( "Double {0}", converted )
converted = Convert.ToString( ObjDouble, provider )
Console.WriteLine( "Object {0}", converted )
converted = Convert.ToString( DayTimeA, provider )
Console.WriteLine( "DateTime {0}", converted )
' The format provider is not called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( BoolA, provider )
Console.WriteLine( "Boolean {0}", converted )
converted = Convert.ToString( StringA, provider )
Console.WriteLine( "String {0}", converted )
converted = Convert.ToString( CharA, provider )
Console.WriteLine( "Char {0}", converted )
converted = Convert.ToString( TSpanA, provider )
Console.WriteLine( "TimeSpan {0}", converted )
converted = Convert.ToString( ObjOther, provider )
Console.WriteLine( "Object {0}", converted )
End Sub
End Module
' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
'
' System.Globalization.NumberFormatInfo Int32 -252645135
' System.Globalization.NumberFormatInfo Double 61680.3855
' System.Globalization.NumberFormatInfo Object -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
'
' Boolean True
' String Qwerty
' Char $
' TimeSpan 00:18:00
' Object DummyProvider
Comentários
Essa implementação é idêntica a Char.ToString() .This implementation is identical to Char.ToString(). O provider parâmetro é ignorado.The provider parameter is ignored.
Aplica-se a
ToString(UInt32)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 32 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation.
public:
static System::String ^ ToString(System::UInt32 value);
[System.CLSCompliant(false)]
public static string ToString (uint value);
[<System.CLSCompliant(false)>]
static member ToString : uint32 -> string
Public Shared Function ToString (value As UInteger) As String
Parâmetros
- value
- UInt32
O inteiro sem sinal de 32 bits a ser convertido.The 32-bit unsigned integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiros sem sinal em sua representação de cadeia de caracteres equivalente.The following example converts each element in an unsigned integer array to its equivalent string representation.
uint[] numbers = { UInt32.MinValue, 103, 1045, 119543, UInt32.MaxValue };
string result;
foreach (uint number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the UInt32 value 0 to the String value 0.
// Converted the UInt32 value 103 to the String value 103.
// Converted the UInt32 value 1045 to the String value 1045.
// Converted the UInt32 value 119543 to the String value 119543.
// Converted the UInt32 value 4294967295 to the String value 4294967295.
Dim numbers() As UInteger = { UInt32.MinValue, 103, 1045, 119543, UInt32.MaxValue }
Dim result As String
For Each number As UInteger In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the UInt32 value 0 to the String value 0.
' Converted the UInt32 value 103 to the String value 103.
' Converted the UInt32 value 1045 to the String value 1045.
' Converted the UInt32 value 119543 to the String value 119543.
' Converted the UInt32 value 4294967295 to the String value 4294967295.
Comentários
Essa implementação é idêntica a UInt32.ToString() .This implementation is identical to UInt32.ToString().
Aplica-se a
ToString(Byte, IFormatProvider)
Converte o valor do inteiro sem sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente, usando as informações de formatação específicas da cultura especificadas.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.
public:
static System::String ^ ToString(System::Byte value, IFormatProvider ^ provider);
public static string ToString (byte value, IFormatProvider provider);
public static string ToString (byte value, IFormatProvider? provider);
static member ToString : byte * IFormatProvider -> string
Public Shared Function ToString (value As Byte, provider As IFormatProvider) As String
Parâmetros
- value
- Byte
O inteiro sem sinal de 8 bits a ser convertido.The 8-bit unsigned integer to convert.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.An object that supplies culture-specific formatting information.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de bytes não assinado em sua representação de cadeia de caracteres equivalente usando as convenções de formatação das culturas en-US e fr-FR.The following example converts each element in an unsigned byte array to its equivalent string representation using the formatting conventions of the en-US and fr-FR cultures. Como o especificador "G", por padrão, gera apenas dígitos decimais na representação de cadeia de caracteres de um valor de byte, o provider parâmetro não afeta a formatação da cadeia de caracteres retornada.Because the "G" specifier by default outputs only decimal digits in a byte value's string representation, the provider parameter does not affect the formatting of the returned string.
byte[] numbers = { 12, 100, Byte.MaxValue };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR" };
foreach (byte number in numbers)
{
Console.WriteLine("{0}:", Convert.ToString(number,
System.Globalization.CultureInfo.InvariantCulture));
foreach (string cultureName in cultureNames)
{
System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
Console.WriteLine(" {0}: {1,20}",
culture.Name, Convert.ToString(number, culture));
}
Console.WriteLine();
}
// The example displays the following output:
// 12:
// en-US: 12
// fr-FR: 12
//
// 100:
// en-US: 100
// fr-FR: 100
//
// 255:
// en-US: 255
// fr-FR: 255
' Define an array of numbers to display.
Dim numbers() As Byte = { 12, 100, Byte.MaxValue }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR" }
For Each number As Byte In numbers
Console.WriteLine("{0}:", Convert.ToString(number, _
System.Globalization.CultureInfo.InvariantCulture))
For Each cultureName As String In cultureNames
Dim culture As New System.Globalization.CultureInfo(cultureName)
Console.WriteLine(" {0}: {1,20}", _
culture.Name, Convert.ToString(number, culture))
Next
Console.WriteLine()
Next
' The example displays the following output:
' 12:
' en-US: 12
' fr-FR: 12
'
' 100:
' en-US: 100
' fr-FR: 100
'
' 255:
' en-US: 255
' fr-FR: 255
Comentários
Essa implementação é idêntica a Byte.ToString .This implementation is identical to Byte.ToString.
Aplica-se a
ToString(Boolean)
Converte o valor booliano especificado na representação de cadeia de caracteres equivalente.Converts the specified Boolean value to its equivalent string representation.
public:
static System::String ^ ToString(bool value);
public static string ToString (bool value);
static member ToString : bool -> string
Public Shared Function ToString (value As Boolean) As String
Parâmetros
- value
- Boolean
O valor booliano a ser convertido.The Boolean value to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir ilustra a conversão de um Boolean para um String , usando ToString .The following example illustrates the conversion of a Boolean to a String, using ToString. Ele também ilustra que a cadeia de caracteres retornada pela conversão é igual a Boolean.TrueString ou Boolean.FalseString .It also illustrates that the string returned by the conversion equals either Boolean.TrueString or Boolean.FalseString.
bool falseFlag = false;
bool trueFlag = true;
Console.WriteLine(Convert.ToString(falseFlag));
Console.WriteLine(Convert.ToString(falseFlag).Equals(Boolean.FalseString));
Console.WriteLine(Convert.ToString(trueFlag));
Console.WriteLine(Convert.ToString(trueFlag).Equals(Boolean.TrueString));
// The example displays the following output:
// False
// True
// True
// True
Dim falseFlag As Boolean = False
Dim trueFlag As Boolean = True
Console.WriteLine(Convert.ToString(falseFlag))
Console.WriteLine(Convert.ToString(falseFlag).Equals(Boolean.FalseString))
Console.WriteLine(Convert.ToString(trueFlag))
Console.WriteLine(Convert.ToString(trueFlag).Equals(Boolean.TrueString))
' The example displays the following output:
' False
' True
' True
' True
let falseFlag = false
let trueFlag = true
Console.WriteLine (Convert.ToString falseFlag)
Console.WriteLine (Convert.ToString falseFlag=Boolean.FalseString)
Console.WriteLine (Convert.ToString trueFlag)
Console.WriteLine (Convert.ToString trueFlag=Boolean.TrueString)
// The example displays the following output:
// False
// True
// True
// True
Comentários
Essa implementação é idêntica a Boolean.ToString .This implementation is identical to Boolean.ToString. Ele retorna Boolean.TrueString para true valores e Boolean.FalseString valores false .It returns Boolean.TrueString for true values and Boolean.FalseString for false values.
Aplica-se a
ToString(Byte)
Converte o valor do inteiro sem sinal de 8 bits especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation.
public:
static System::String ^ ToString(System::Byte value);
public static string ToString (byte value);
static member ToString : byte -> string
Public Shared Function ToString (value As Byte) As String
Parâmetros
- value
- Byte
O inteiro sem sinal de 8 bits a ser convertido.The 8-bit unsigned integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada valor em uma Byte matriz em uma cadeia de caracteres.The following example converts each value in a Byte array to a string.
using System;
public class Example
{
public static void Main()
{
byte[] values = { Byte.MinValue, 12, 100, 179, Byte.MaxValue } ;
foreach (var value in values)
Console.WriteLine("{0,3} ({1}) --> {2}", value,
value.GetType().Name,
Convert.ToString(value));
}
}
// The example displays the following output:
// 0 (Byte) --> 0
// 12 (Byte) --> 12
// 100 (Byte) --> 100
// 179 (Byte) --> 179
// 255 (Byte) --> 255
Public Module Example
Public Sub Main()
Dim values() As Byte = { Byte.MinValue, 12, 100, 179, Byte.MaxValue }
For Each value In values
Console.WriteLine("{0,3} ({1}) --> {2}", value,
value.GetType().Name,
Convert.ToString(value))
Next
End Sub
End Module
' The example displays the following output:
' 0 (Byte) --> 0
' 12 (Byte) --> 12
' 100 (Byte) --> 100
' 179 (Byte) --> 179
' 255 (Byte) --> 255
let values = [ Byte.MinValue; 12uy; 100uy; 179uy; Byte.MaxValue ]
for value in values do
printfn "% 4i (%s) --> %s" value (value.GetType().Name) (Convert.ToString value)
// The example displays the following output:
// 0 (Byte) --> 0
// 12 (Byte) --> 12
// 100 (Byte) --> 100
// 179 (Byte) --> 179
// 255 (Byte) --> 255
Comentários
Essa implementação é idêntica a Byte.ToString() .This implementation is identical to Byte.ToString().
Aplica-se a
ToString(Char)
Converte o valor do caractere Unicode especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified Unicode character to its equivalent string representation.
public:
static System::String ^ ToString(char value);
public static string ToString (char value);
static member ToString : char -> string
Public Shared Function ToString (value As Char) As String
Parâmetros
- value
- Char
O caractere Unicode a ser convertido.The Unicode character to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um Char para um String .The following example converts a Char to a String.
public:
void ConvertStringChar( String^ stringVal )
{
Char charVal = 'a';
// A String must be one character long to convert to char.
try
{
charVal = System::Convert::ToChar( stringVal );
System::Console::WriteLine( " {0} as a char is {1}",
stringVal, charVal );
}
catch ( System::FormatException^ )
{
System::Console::WriteLine(
"The String is longer than one character." );
}
catch ( System::ArgumentNullException^ )
{
System::Console::WriteLine( "The String is 0." );
}
// A char to String conversion will always succeed.
stringVal = System::Convert::ToString( charVal );
System::Console::WriteLine( "The character as a String is {0}",
stringVal );
}
public void ConvertStringChar(string stringVal) {
char charVal = 'a';
// A string must be one character long to convert to char.
try {
charVal = System.Convert.ToChar(stringVal);
System.Console.WriteLine("{0} as a char is {1}",
stringVal, charVal);
}
catch (System.FormatException) {
System.Console.WriteLine(
"The string is longer than one character.");
}
catch (System.ArgumentNullException) {
System.Console.WriteLine("The string is null.");
}
// A char to string conversion will always succeed.
stringVal = System.Convert.ToString(charVal);
System.Console.WriteLine("The character as a string is {0}",
stringVal);
}
Public Sub ConvertStringChar(ByVal stringVal As String)
Dim charVal As Char = "a"c
' A string must be one character long to convert to char.
Try
charVal = System.Convert.ToChar(stringVal)
System.Console.WriteLine("{0} as a char is {1}", _
stringVal, charVal)
Catch exception As System.FormatException
System.Console.WriteLine( _
"The string is longer than one character.")
Catch exception As System.ArgumentNullException
System.Console.WriteLine("The string is null.")
End Try
' A char to string conversion will always succeed.
stringVal = System.Convert.ToString(charVal)
System.Console.WriteLine("The character as a string is {0}", _
stringVal)
End Sub
Comentários
Essa implementação é idêntica a Char.ToString .This implementation is identical to Char.ToString.
Aplica-se a
ToString(DateTime)
public:
static System::String ^ ToString(DateTime value);
public static string ToString (DateTime value);
static member ToString : DateTime -> string
Public Shared Function ToString (value As DateTime) As String
Parâmetros
- value
- DateTime
O valor de data e tempo a ser convertido.The date and time value to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de um DateTime valor em um String valor.The following example converts each element in an array of a DateTime value to a String value.
DateTime[] dates = { new DateTime(2009, 7, 14),
new DateTime(1, 1, 1, 18, 32, 0),
new DateTime(2009, 2, 12, 7, 16, 0) };
string result;
foreach (DateTime dateValue in dates)
{
result = Convert.ToString(dateValue);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
dateValue.GetType().Name, dateValue,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the DateTime value 7/14/2009 12:00:00 AM to a String value 7/14/2009 12:00:00 AM.
// Converted the DateTime value 1/1/0001 06:32:00 PM to a String value 1/1/0001 06:32:00 PM.
// Converted the DateTime value 2/12/2009 07:16:00 AM to a String value 2/12/2009 07:16:00 AM.
Dim dates() As Date = { #07/14/2009#, #6:32PM#, #02/12/2009 7:16AM#}
Dim result As String
For Each dateValue As Date In dates
result = Convert.ToString(dateValue)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
dateValue.GetType().Name, dateValue, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the DateTime value 7/14/2009 12:00:00 AM to a String value 7/14/2009 12:00:00 AM.
' Converted the DateTime value 1/1/0001 06:32:00 PM to a String value 1/1/0001 06:32:00 PM.
' Converted the DateTime value 2/12/2009 07:16:00 AM to a String value 2/12/2009 07:16:00 AM.
Comentários
Essa implementação é idêntica a DateTime.ToString() .This implementation is identical to DateTime.ToString(). Ele usa as convenções de formatação da cultura atual e o especificador de formato "G" para converter um DateTime valor em sua representação de cadeia de caracteres.It uses the formatting conventions of the current culture and the "G" format specifier to convert a DateTime value to its string representation.
Aplica-se a
ToString(Double)
Converte o valor do número de ponto flutuante de precisão dupla especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified double-precision floating-point number to its equivalent string representation.
public:
static System::String ^ ToString(double value);
public static string ToString (double value);
static member ToString : double -> string
Public Shared Function ToString (value As Double) As String
Parâmetros
- value
- Double
O número de ponto flutuante de precisão dupla a ser convertido.The double-precision floating-point number to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um Double para um String .The following example converts a Double to a String.
public:
void ConvertDoubleString( double doubleVal )
{
String^ stringVal;
// A conversion from Double to String cannot overflow.
stringVal = System::Convert::ToString( doubleVal );
System::Console::WriteLine( " {0} as a String is: {1}",
doubleVal, stringVal );
try
{
doubleVal = System::Convert::ToDouble( stringVal );
System::Console::WriteLine( " {0} as a double is: {1}",
stringVal, doubleVal );
}
catch ( System::OverflowException^ )
{
System::Console::WriteLine( "Conversion from String-to-double overflowed." );
}
catch ( System::FormatException^ )
{
System::Console::WriteLine( "The String was not formatted as a double." );
}
catch ( System::ArgumentException^ )
{
System::Console::WriteLine( "The String pointed to null." );
}
}
public void ConvertDoubleString(double doubleVal) {
string stringVal;
// A conversion from Double to string cannot overflow.
stringVal = System.Convert.ToString(doubleVal);
System.Console.WriteLine("{0} as a string is: {1}",
doubleVal, stringVal);
try {
doubleVal = System.Convert.ToDouble(stringVal);
System.Console.WriteLine("{0} as a double is: {1}",
stringVal, doubleVal);
}
catch (System.OverflowException) {
System.Console.WriteLine(
"Conversion from string-to-double overflowed.");
}
catch (System.FormatException) {
System.Console.WriteLine(
"The string was not formatted as a double.");
}
catch (System.ArgumentException) {
System.Console.WriteLine(
"The string pointed to null.");
}
}
Public Sub ConvertDoubleString(ByVal doubleVal As Double)
Dim stringVal As String
' A conversion from Double to String cannot overflow.
stringVal = System.Convert.ToString(doubleVal)
System.Console.WriteLine("{0} as a String is: {1}", _
doubleVal, stringVal)
Try
doubleVal = System.Convert.ToDouble(stringVal)
System.Console.WriteLine("{0} as a Double is: {1}", _
stringVal, doubleVal)
Catch exception As System.OverflowException
System.Console.WriteLine( _
"Overflow in String-to-Double conversion.")
Catch exception As System.FormatException
System.Console.WriteLine( _
"The string is not formatted as a Double.")
Catch exception As System.ArgumentException
System.Console.WriteLine("The string is null.")
End Try
End Sub
Comentários
Essa implementação é idêntica a Double.ToString() .This implementation is identical to Double.ToString().
Aplica-se a
ToString(Int16)
Converte o valor do inteiro com sinal de 16 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 16-bit signed integer to its equivalent string representation.
public:
static System::String ^ ToString(short value);
public static string ToString (short value);
static member ToString : int16 -> string
Public Shared Function ToString (value As Short) As String
Parâmetros
- value
- Int16
O inteiro assinado de 16 bits a ser convertido.The 16-bit signed integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiros de 16 bits em sua representação de cadeia de caracteres equivalente.The following example converts each element in an array of 16-bit integers to its equivalent string representation.
short[] numbers = { Int16.MinValue, -138, 0, 19, Int16.MaxValue };
string result;
foreach (short number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the Int16 value -32768 to the String value -32768.
// Converted the Int16 value -138 to the String value -138.
// Converted the Int16 value 0 to the String value 0.
// Converted the Int16 value 19 to the String value 19.
// Converted the Int16 value 32767 to the String value 32767.
Dim numbers() As Short = { Int16.MinValue, -138, 0, 19, Int16.MaxValue }
Dim result As String
For Each number As Short In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the Int16 value -32768 to the String value -32768.
' Converted the Int16 value -138 to the String value -138.
' Converted the Int16 value 0 to the String value 0.
' Converted the Int16 value 19 to the String value 19.
' Converted the Int16 value 32767 to the String value 32767.
Comentários
Essa implementação é idêntica a Int16.ToString() .This implementation is identical to Int16.ToString().
Aplica-se a
ToString(Int32)
Converte o valor do inteiro com sinal de 32 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 32-bit signed integer to its equivalent string representation.
public:
static System::String ^ ToString(int value);
public static string ToString (int value);
static member ToString : int -> string
Public Shared Function ToString (value As Integer) As String
Parâmetros
- value
- Int32
O inteiro com sinal de 32 bits a converter.The 32-bit signed integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir compara o ToString(Int32) método com o ToString(UInt16, IFormatProvider) método.The following example compares the ToString(Int32) method with the ToString(UInt16, IFormatProvider) method. Ele define um NumberFormatInfo objeto personalizado que usa a cadeia "menos" para representar o sinal negativo.It defines a custom NumberFormatInfo object that uses the sting "minus" to represent the negative sign. Ele converte cada elemento em uma matriz de inteiros em sua representação de cadeia de caracteres equivalente usando a formatação padrão (as convenções de formatação da cultura atual) e o provedor de formato personalizado.It converts each element in an integer array to its equivalent string representation using default formatting (the formatting conventions of the current culture) and the custom format provider.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Create a NumberFormatInfo object and set its NegativeSigns
// property to use for integer formatting.
NumberFormatInfo provider = new NumberFormatInfo();
provider.NegativeSign = "minus ";
int[] values = { -20, 0, 100 };
Console.WriteLine("{0,-8} --> {1,10} {2,10}\n", "Value",
CultureInfo.CurrentCulture.Name,
"Custom");
foreach (int value in values)
Console.WriteLine("{0,-8} --> {1,10} {2,10}",
value, Convert.ToString(value),
Convert.ToString(value, provider));
// The example displays output like the following:
// Value --> en-US Custom
//
// -20 --> -20 minus 20
// 0 --> 0 0
// 100 --> 100 100
}
}
Imports System.Globalization
Module Example
Public Sub Main()
' Create a NumberFormatInfo object and set its NegativeSigns
' property to use for integer formatting.
Dim provider As New NumberFormatInfo()
provider.NegativeSign = "minus "
Dim values() As Integer = { -20, 0, 100 }
Console.WriteLine("{0,-8} --> {1,10} {2,10}", "Value",
CultureInfo.CurrentCulture.Name,
"Custom")
Console.WriteLine()
For Each value As Integer In values
Console.WriteLine("{0,-8} --> {1,10} {2,10}",
value, Convert.ToString(value),
Convert.ToString(value, provider))
Next
End Sub
End Module
' The example displays output like the following:
' Value --> en-US Custom
'
' -20 --> -20 minus 20
' 0 --> 0 0
' 100 --> 100 100
Comentários
Essa implementação é idêntica a Int32.ToString() .This implementation is identical to Int32.ToString(). Ele formata value usando as convenções de formatação da cultura de thread atual.It formats value by using the formatting conventions of the current thread culture.
Aplica-se a
ToString(Decimal)
Converte o valor do número decimal especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified decimal number to its equivalent string representation.
public:
static System::String ^ ToString(System::Decimal value);
public static string ToString (decimal value);
static member ToString : decimal -> string
Public Shared Function ToString (value As Decimal) As String
Parâmetros
- value
- Decimal
O número decimal a ser convertido.The decimal number to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um Decimal para um String .The following example converts a Decimal to a String.
public:
void ConvertStringDecimal( String^ stringVal )
{
Decimal decimalVal = 0;
try
{
decimalVal = System::Convert::ToDecimal( stringVal );
System::Console::WriteLine( "The String as a decimal is {0}.",
decimalVal );
}
catch ( System::OverflowException^ )
{
System::Console::WriteLine(
"The conversion from String to decimal overflowed." );
}
catch ( System::FormatException^ )
{
System::Console::WriteLine(
"The String is not formatted as a decimal." );
}
catch ( System::ArgumentNullException^ )
{
System::Console::WriteLine( "The String is 0." );
}
// Decimal to String conversion will not overflow.
stringVal = System::Convert::ToString( decimalVal );
System::Console::WriteLine(
"The decimal as a String is {0}.", stringVal );
}
public void ConvertStringDecimal(string stringVal) {
decimal decimalVal = 0;
try {
decimalVal = System.Convert.ToDecimal(stringVal);
System.Console.WriteLine(
"The string as a decimal is {0}.", decimalVal);
}
catch (System.OverflowException){
System.Console.WriteLine(
"The conversion from string to decimal overflowed.");
}
catch (System.FormatException) {
System.Console.WriteLine(
"The string is not formatted as a decimal.");
}
catch (System.ArgumentNullException) {
System.Console.WriteLine(
"The string is null.");
}
// Decimal to string conversion will not overflow.
stringVal = System.Convert.ToString(decimalVal);
System.Console.WriteLine(
"The decimal as a string is {0}.", stringVal);
}
Public Sub ConvertStringDecimal(ByVal stringVal As String)
Dim decimalVal As Decimal = 0
Try
decimalVal = System.Convert.ToDecimal(stringVal)
System.Console.WriteLine("The string as a decimal is {0}.", _
decimalVal)
Catch exception As System.OverflowException
System.Console.WriteLine( _
"Overflow in string-to-decimal conversion.")
Catch exception As System.FormatException
System.Console.WriteLine( _
"The string is not formatted as a decimal.")
Catch exception As System.ArgumentException
System.Console.WriteLine("The string is null.")
End Try
' Decimal to string conversion will not overflow.
stringVal = System.Convert.ToString(decimalVal)
System.Console.WriteLine("The decimal as a string is {0}.", _
stringVal)
End Sub
Comentários
Essa implementação é idêntica a Decimal.ToString() .This implementation is identical to Decimal.ToString().
Aplica-se a
ToString(Object)
Converte o valor do objeto especificado na representação de cadeia de caracteres equivalente.Converts the value of the specified object to its equivalent string representation.
public:
static System::String ^ ToString(System::Object ^ value);
public static string ToString (object value);
public static string? ToString (object? value);
static member ToString : obj -> string
Public Shared Function ToString (value As Object) As String
Parâmetros
- value
- Object
Um objeto que fornece o valor a ser convertido ou null.An object that supplies the value to convert, or null.
Retornos
A representação de cadeia de caracteres de value, ou Empty se value for null.The string representation of value, or Empty if value is null.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de objeto em sua representação de cadeia de caracteres equivalente.The following example converts each element in an object array to its equivalent string representation.
object[] values = { false, 12.63m, new DateTime(2009, 6, 1, 6, 32, 15), 16.09e-12,
'Z', 15.15322, SByte.MinValue, Int32.MaxValue };
string result;
foreach (object value in values)
{
result = Convert.ToString(value);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
value.GetType().Name, value,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the Boolean value False to the String value False.
// Converted the Decimal value 12.63 to the String value 12.63.
// Converted the DateTime value 6/1/2009 06:32:15 AM to the String value 6/1/2009 06:32:15 AM.
// Converted the Double value 1.609E-11 to the String value 1.609E-11.
// Converted the Char value Z to the String value Z.
// Converted the Double value 15.15322 to the String value 15.15322.
// Converted the SByte value -128 to the String value -128.
// Converted the Int32 value 2147483647 to the String value 2147483647.
Dim values() As Object = { False, 12.63d, #06/01/2009 6:32:15#, 16.09e-12, _
"Z"c, 15.15322, SByte.MinValue, Int32.MaxValue}
Dim result As String
For Each value As Object In values
result = Convert.ToString(value)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
value.GetType().Name, value, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the Boolean value False to the String value False.
' Converted the Decimal value 12.63 to the String value 12.63.
' Converted the DateTime value 6/1/2009 06:32:15 AM to the String value 6/1/2009 06:32:15 AM.
' Converted the Double value 1.609E-11 to the String value 1.609E-11.
' Converted the Char value Z to the String value Z.
' Converted the Double value 15.15322 to the String value 15.15322.
' Converted the SByte value -128 to the String value -128.
' Converted the Int32 value 2147483647 to the String value 2147483647.
Comentários
Para converter value em sua representação de cadeia de caracteres, o método tenta chamar a IConvertible.ToString implementação de value .To convert value to its string representation, the method tries to call the IConvertible.ToString implementation of value. Se o não value implementar a IConvertible interface, o método tentará chamar a IFormattable.ToString implementação de value .If value does not implement the IConvertible interface, the method tries to call the IFormattable.ToString implementation of value. Se o valor não implementar a IFormattable interface, o método chamará o ToString método do tipo subjacente de value .If value does not implement the IFormattable interface, the method calls the ToString method of the underlying type of value.
Aplica-se a
ToString(SByte)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro com sinal de 8 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 8-bit signed integer to its equivalent string representation.
public:
static System::String ^ ToString(System::SByte value);
[System.CLSCompliant(false)]
public static string ToString (sbyte value);
[<System.CLSCompliant(false)>]
static member ToString : sbyte -> string
Public Shared Function ToString (value As SByte) As String
Parâmetros
- value
- SByte
O inteiro com sinal de 8 bits a ser convertido.The 8-bit signed integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de bytes assinada em sua representação de cadeia de caracteres equivalente.The following example converts each element in a signed byte array to its equivalent string representation.
sbyte[] numbers = { SByte.MinValue, -12, 0, 16, SByte.MaxValue };
string result;
foreach (sbyte number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the SByte value -128 to the String value -128.
// Converted the SByte value -12 to the String value -12.
// Converted the SByte value 0 to the String value 0.
// Converted the SByte value 16 to the String value 16.
// Converted the SByte value 127 to the String value 127.
Dim numbers() As SByte = { SByte.MinValue, -12, 0, 16, SByte.MaxValue }
Dim result As String
For Each number As SByte In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the SByte value -128 to the String value -128.
' Converted the SByte value -12 to the String value -12.
' Converted the SByte value 0 to the String value 0.
' Converted the SByte value 16 to the String value 16.
' Converted the SByte value 127 to the String value 127.
Comentários
Essa implementação é idêntica a SByte.ToString() .This implementation is identical to SByte.ToString().
Aplica-se a
ToString(Single)
Converte o valor do número de ponto flutuante de precisão simples especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified single-precision floating-point number to its equivalent string representation.
public:
static System::String ^ ToString(float value);
public static string ToString (float value);
static member ToString : single -> string
Public Shared Function ToString (value As Single) As String
Parâmetros
- value
- Single
O número de ponto flutuante de precisão simples a ser convertido.The single-precision floating-point number to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de Single valores em sua representação de cadeia de caracteres equivalente.The following example converts each element in an array of Single values to its equivalent string representation.
float[] numbers = { Single.MinValue, -1011.351f, -17.45f, -3e-16f,
0f, 4.56e-12f, 16.0001f, 10345.1221f, Single.MaxValue };
string result;
foreach (float number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the Single value -3.402823E+38 to the String value -3.402823E+38.
// Converted the Single value -1011.351 to the String value -1011.351.
// Converted the Single value -17.45 to the String value -17.45.
// Converted the Single value -3E-16 to the String value -3E-16.
// Converted the Single value 0 to the String value 0.
// Converted the Single value 4.56E-12 to the String value 4.56E-12.
// Converted the Single value 16.0001 to the String value 16.0001.
// Converted the Single value 10345.12 to the String value 10345.12.
// Converted the Single value 3.402823E+38 to the String value 3.402823E+38.
Dim numbers() As Single = { Single.MinValue, -1011.351, -17.45, -3e-16, _
0, 4.56e-12, 16.0001, 10345.1221, Single.MaxValue }
Dim result As String
For Each number As Single In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the Single value -3.402823E+38 to the String value -3.402823E+38.
' Converted the Single value -1011.351 to the String value -1011.351.
' Converted the Single value -17.45 to the String value -17.45.
' Converted the Single value -3E-16 to the String value -3E-16.
' Converted the Single value 0 to the String value 0.
' Converted the Single value 4.56E-12 to the String value 4.56E-12.
' Converted the Single value 16.0001 to the String value 16.0001.
' Converted the Single value 10345.12 to the String value 10345.12.
' Converted the Single value 3.402823E+38 to the String value 3.402823E+38.
Comentários
Essa implementação é idêntica a Single.ToString() .This implementation is identical to Single.ToString().
Aplica-se a
ToString(String)
Retorna a instância de cadeia de caracteres especificada; nenhuma conversão real é executada.Returns the specified string instance; no actual conversion is performed.
public:
static System::String ^ ToString(System::String ^ value);
public static string? ToString (string? value);
public static string ToString (string value);
static member ToString : string -> string
Public Shared Function ToString (value As String) As String
Parâmetros
- value
- String
A cadeia de caracteres a ser retornada.The string to return.
Retornos
value é retornado inalterado.value is returned unchanged.
Exemplos
O exemplo a seguir passa uma cadeia de caracteres para o ToString(String) método e chama o Object.ReferenceEquals método para confirmar que o método retorna a cadeia de caracteres original.The following example passes a string to the ToString(String) method and calls the Object.ReferenceEquals method to confirm that the method returns the original string. O exemplo também chama o String.IsInterned método para garantir que as duas cadeias de caracteres não sejam idênticas, pois a cadeia original é interna.The example also calls the String.IsInterned method to ensure that the two strings are not identical because the original string is interned.
using System;
public class Example
{
public static void Main()
{
String article = "An";
String noun = "apple";
String str1 = String.Format("{0} {1}", article, noun);
String str2 = Convert.ToString(str1);
Console.WriteLine("str1 is interned: {0}",
! (String.IsInterned(str1) == null));
Console.WriteLine("str1 and str2 are the same reference: {0}",
Object.ReferenceEquals(str1, str2));
}
}
// The example displays the following output:
// str1 is interned: False
// str1 and str2 are the same reference: True
Module Example
Public Sub Main()
Dim article As String = "An"
Dim noun As String = "apple"
Dim str1 As String = String.Format("{0} {1}", article, noun)
Dim str2 As String = Convert.ToString(str1)
Console.WriteLine("str1 is interned: {0}",
Not String.IsInterned(str1) Is Nothing)
Console.WriteLine("str1 and str2 are the same reference: {0}",
Object.ReferenceEquals(str1, str2))
End Sub
End Module
' The example displays the following output:
' str1 is interned: False
' str1 and str2 are the same reference: True
Aplica-se a
ToString(UInt16)
Importante
Esta API não está em conformidade com CLS.
Converte o valor do inteiro sem sinal de 16 bits especificado em uma representação de cadeia de caracteres equivalente.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation.
public:
static System::String ^ ToString(System::UInt16 value);
[System.CLSCompliant(false)]
public static string ToString (ushort value);
[<System.CLSCompliant(false)>]
static member ToString : uint16 -> string
Public Shared Function ToString (value As UShort) As String
Parâmetros
- value
- UInt16
O inteiro não assinado de 16 bits a ser convertido.The 16-bit unsigned integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
- Atributos
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de valores inteiros de 16 bits não assinados em sua representação de cadeia de caracteres equivalente.The following example converts each element in an array of unsigned 16-bit integer values to its equivalent string representation.
ushort[] numbers = { UInt16.MinValue, 103, 1045, UInt16.MaxValue };
string result;
foreach (ushort number in numbers)
{
result = Convert.ToString(number);
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
number.GetType().Name, number,
result.GetType().Name, result);
}
// The example displays the following output:
// Converted the UInt16 value 0 to the String value 0.
// Converted the UInt16 value 103 to the String value 103.
// Converted the UInt16 value 1045 to the String value 1045.
// Converted the UInt16 value 65535 to the String value 65535.
Dim numbers() As UShort = { UInt16.MinValue, 103, 1045, UInt16.MaxValue }
Dim result As String
For Each number As UShort In numbers
result = Convert.ToString(number)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
number.GetType().Name, number, _
result.GetType().Name, result)
Next
' The example displays the following output:
' Converted the UInt16 value 0 to the String value 0.
' Converted the UInt16 value 103 to the String value 103.
' Converted the UInt16 value 1045 to the String value 1045.
' Converted the UInt16 value 65535 to the String value 65535.
Comentários
Essa implementação é idêntica a UInt16.ToString() .This implementation is identical to UInt16.ToString().
Aplica-se a
ToString(Byte, Int32)
Converte o valor de um inteiro sem sinal de 8 bits em sua representação de cadeia de caracteres equivalente de uma base especificada.Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.
public:
static System::String ^ ToString(System::Byte value, int toBase);
public static string ToString (byte value, int toBase);
static member ToString : byte * int -> string
Public Shared Function ToString (value As Byte, toBase As Integer) As String
Parâmetros
- value
- Byte
O inteiro sem sinal de 8 bits a ser convertido.The 8-bit unsigned integer to convert.
- toBase
- Int32
A base do valor de retorno, que deve ser 2, 8, 10 ou 16.The base of the return value, which must be 2, 8, 10, or 16.
Retornos
A representação da cadeia de caracteres de value na base toBase.The string representation of value in base toBase.
Exceções
toBase não é 2, 8, 10 ou 16.toBase is not 2, 8, 10, or 16.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de bytes em seu binário equivalente, hexadecimal, decimal e representações de cadeia de caracteres hexadecimal.The following example converts each element in a byte array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.
int[] bases = { 2, 8, 10, 16};
byte[] numbers = { Byte.MinValue, 12, 103, Byte.MaxValue};
foreach (int baseValue in bases)
{
Console.WriteLine("Base {0} conversion:", baseValue);
foreach (byte number in numbers)
{
Console.WriteLine(" {0,-5} --> 0x{1}",
number, Convert.ToString(number, baseValue));
}
}
// The example displays the following output:
// Base 2 conversion:
// 0 --> 0x0
// 12 --> 0x1100
// 103 --> 0x1100111
// 255 --> 0x11111111
// Base 8 conversion:
// 0 --> 0x0
// 12 --> 0x14
// 103 --> 0x147
// 255 --> 0x377
// Base 10 conversion:
// 0 --> 0x0
// 12 --> 0x12
// 103 --> 0x103
// 255 --> 0x255
// Base 16 conversion:
// 0 --> 0x0
// 12 --> 0xc
// 103 --> 0x67
// 255 --> 0xff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Byte = { Byte.MinValue, 12, 103, Byte.MaxValue}
For Each base As Integer In bases
Console.WriteLine("Base {0} conversion:", base)
For Each number As Byte In numbers
Console.WriteLine(" {0,-5} --> 0x{1}", _
number, Convert.ToString(number, base))
Next
Next
' The example displays the following output:
' Base 2 conversion:
' 0 --> 0x0
' 12 --> 0x1100
' 103 --> 0x1100111
' 255 --> 0x11111111
' Base 8 conversion:
' 0 --> 0x0
' 12 --> 0x14
' 103 --> 0x147
' 255 --> 0x377
' Base 10 conversion:
' 0 --> 0x0
' 12 --> 0x12
' 103 --> 0x103
' 255 --> 0x255
' Base 16 conversion:
' 0 --> 0x0
' 12 --> 0xc
' 103 --> 0x67
' 255 --> 0xff
let bases = [2; 8; 10; 16]
let numbers = [ Byte.MinValue; 12uy; 103uy; Byte.MaxValue ]
for baseValue in bases do
printfn "Base %i conversion:" baseValue
for number in numbers do
printfn " % -5i --> 0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
// Base 2 conversion:
// 0 --> 0x0
// 12 --> 0x1100
// 103 --> 0x1100111
// 255 --> 0x11111111
// Base 8 conversion:
// 0 --> 0x0
// 12 --> 0x14
// 103 --> 0x147
// 255 --> 0x377
// Base 10 conversion:
// 0 --> 0x0
// 12 --> 0x12
// 103 --> 0x103
// 255 --> 0x255
// Base 16 conversion:
// 0 --> 0x0
// 12 --> 0xc
// 103 --> 0x67
// 255 --> 0xff
Comentários
Se não for toBase igual a 10, a cadeia de caracteres retornada pelo Convert.ToString(Byte, Int32) método representará value somente por sua magnitude.If toBase does not equal 10, the string that is returned by the Convert.ToString(Byte, Int32) method represents value by its magnitude only. Se o método for chamado para criar uma cadeia de caracteres que posteriormente será convertida de volta em um número, um método correspondente que assume uma representação numérica somente de magnitude deve ser chamado para executar a conversão.If the method is called to create a string that will later be converted back to a number, a corresponding method that assumes a magnitude-only numeric representation should be called to perform the conversion. Esses métodos incluem Convert.ToByte(String, Int32) ou Byte.Parse(String, NumberStyles) .Such methods include Convert.ToByte(String, Int32) or Byte.Parse(String, NumberStyles).
Aplica-se a
ToString(Boolean, IFormatProvider)
Converte o valor booliano especificado na representação de cadeia de caracteres equivalente.Converts the specified Boolean value to its equivalent string representation.
public:
static System::String ^ ToString(bool value, IFormatProvider ^ provider);
public static string ToString (bool value, IFormatProvider provider);
public static string ToString (bool value, IFormatProvider? provider);
static member ToString : bool * IFormatProvider -> string
Public Shared Function ToString (value As Boolean, provider As IFormatProvider) As String
Parâmetros
- value
- Boolean
O valor booliano a ser convertido.The Boolean value to convert.
- provider
- IFormatProvider
Uma instância de um objeto.An instance of an object. Este parâmetro é ignorado.This parameter is ignored.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte um Boolean valor em um String com o ToString método, usando um IFormatProvider objeto que exibe o tipo do provedor de formato para o qual ele é chamado.The following example converts a Boolean value to a String with the ToString method, using an IFormatProvider object that displays the type of the format provider for which it is called. O exemplo mostra que o IFormatProvider objeto não é referenciado.The example shows that the IFormatProvider object is not referenced.
// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;
#define null (Object^)0
// An instance of this class can be passed to methods that require
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
virtual Object^ GetFormat( Type^ argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console::Write( "{0,-40}", argType->ToString() );
return null;
}
};
int main()
{
// Create an instance of the IFormatProvider.
DummyProvider^ provider = gcnew DummyProvider;
String^ converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
Object^ ObjDouble = -98765.4321;
DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
bool BoolA = true;
String^ StringA = "Qwerty";
Char CharA = '$';
TimeSpan TSpanA = TimeSpan(0,18,0);
Object^ ObjOther = static_cast<Object^>(provider);
Console::WriteLine( "This example of "
"Convert::ToString( non-numeric, IFormatProvider* ) \n"
"generates the following output. The provider type, "
"argument type, \nand argument value are displayed." );
Console::WriteLine( "\nNote: The IFormatProvider object is "
"not called for Boolean, String, \nChar, TimeSpan, "
"and non-numeric Object." );
// The format provider is called for these conversions.
Console::WriteLine();
converted = Convert::ToString( Int32A, provider );
Console::WriteLine( "int {0}", converted );
converted = Convert::ToString( DoubleA, provider );
Console::WriteLine( "double {0}", converted );
converted = Convert::ToString( ObjDouble, provider );
Console::WriteLine( "Object {0}", converted );
converted = Convert::ToString( DayTimeA, provider );
Console::WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console::WriteLine();
converted = Convert::ToString( BoolA, provider );
Console::WriteLine( "bool {0}", converted );
converted = Convert::ToString( StringA, provider );
Console::WriteLine( "String {0}", converted );
converted = Convert::ToString( CharA, provider );
Console::WriteLine( "Char {0}", converted );
converted = Convert::ToString( TSpanA, provider );
Console::WriteLine( "TimeSpan {0}", converted );
converted = Convert::ToString( ObjOther, provider );
Console::WriteLine( "Object {0}", converted );
}
/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo Object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
String Qwerty
Char $
TimeSpan 00:18:00
Object DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;
// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
// Normally, GetFormat returns an object of the requested type
// (usually itself) if it is able; otherwise, it returns Nothing.
public object GetFormat( Type argType )
{
// Here, the type of argType is displayed, and GetFormat
// always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) );
return null;
}
}
class ConvertNonNumericProviderDemo
{
static void Main( )
{
// Create an instance of the IFormatProvider.
DummyProvider provider = new DummyProvider( );
string converted;
// Convert these values using DummyProvider.
int Int32A = -252645135;
double DoubleA = 61680.3855;
object ObjDouble = (object)( -98765.4321 );
DateTime DayTimeA = new DateTime( 2001, 9, 11, 13, 45, 0 );
bool BoolA = true;
string StringA = "Qwerty";
char CharA = '$';
TimeSpan TSpanA = new TimeSpan( 0, 18, 0 );
object ObjOther = (object)provider;
Console.WriteLine( "This example of " +
"Convert.ToString( non-numeric, IFormatProvider ) \n" +
"generates the following output. The provider type, " +
"argument type, \nand argument value are displayed." );
Console.WriteLine( "\nNote: The IFormatProvider object is " +
"not called for Boolean, String, \nChar, TimeSpan, " +
"and non-numeric Object." );
// The format provider is called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( Int32A, provider );
Console.WriteLine( "int {0}", converted );
converted = Convert.ToString( DoubleA, provider );
Console.WriteLine( "double {0}", converted );
converted = Convert.ToString( ObjDouble, provider );
Console.WriteLine( "object {0}", converted );
converted = Convert.ToString( DayTimeA, provider );
Console.WriteLine( "DateTime {0}", converted );
// The format provider is not called for these conversions.
Console.WriteLine( );
converted = Convert.ToString( BoolA, provider );
Console.WriteLine( "bool {0}", converted );
converted = Convert.ToString( StringA, provider );
Console.WriteLine( "string {0}", converted );
converted = Convert.ToString( CharA, provider );
Console.WriteLine( "char {0}", converted );
converted = Convert.ToString( TSpanA, provider );
Console.WriteLine( "TimeSpan {0}", converted );
converted = Convert.ToString( ObjOther, provider );
Console.WriteLine( "object {0}", converted );
}
}
/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.
Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.
System.Globalization.NumberFormatInfo int -252645135
System.Globalization.NumberFormatInfo double 61680.3855
System.Globalization.NumberFormatInfo object -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
bool True
string Qwerty
char $
TimeSpan 00:18:00
object DummyProvider
*/
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization
' An instance of this class can be passed to methods that require
' an IFormatProvider.
Public Class DummyProvider
Implements IFormatProvider
' Normally, GetFormat returns an object of the requested type
' (usually itself) if it is able; otherwise, it returns Nothing.
Public Function GetFormat( argType As Type ) As Object _
Implements IFormatProvider.GetFormat
' Here, the type of argType is displayed, and GetFormat
' always returns Nothing.
Console.Write( "{0,-40}", argType.ToString( ) )
Return Nothing
End Function
End Class
Module ConvertNonNumericProviderDemo
Sub Main( )
' Create an instance of the IFormatProvider.
Dim provider As New DummyProvider( )
Dim converted As String
' Convert these values using DummyProvider.
Dim Int32A As Integer = -252645135
Dim DoubleA As Double = 61680.3855
Dim ObjDouble As Object = CType( -98765.4321, Object )
Dim DayTimeA As DateTime = _
new DateTime( 2001, 9, 11, 13, 45, 0 )
Dim BoolA As Boolean = True
Dim StringA As String = "Qwerty"
Dim CharA As Char = "$"c
Dim TSpanA As TimeSpan = New TimeSpan( 0, 18, 0 )
Dim ObjOther As Object = CType( provider, Object )
Console.WriteLine( "This example of " & _
"Convert.ToString( non-numeric, IFormatProvider ) " & _
vbCrLf & "generates the following output. The " & _
"provider type, argument type, " & vbCrLf & "and " & _
"argument value are displayed." )
Console.WriteLine( vbCrLf & _
"Note: The IFormatProvider object is not called for " & _
"Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
"and non-numeric Object." )
' The format provider is called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( Int32A, provider )
Console.WriteLine( "Int32 {0}", converted )
converted = Convert.ToString( DoubleA, provider )
Console.WriteLine( "Double {0}", converted )
converted = Convert.ToString( ObjDouble, provider )
Console.WriteLine( "Object {0}", converted )
converted = Convert.ToString( DayTimeA, provider )
Console.WriteLine( "DateTime {0}", converted )
' The format provider is not called for these conversions.
Console.WriteLine( )
converted = Convert.ToString( BoolA, provider )
Console.WriteLine( "Boolean {0}", converted )
converted = Convert.ToString( StringA, provider )
Console.WriteLine( "String {0}", converted )
converted = Convert.ToString( CharA, provider )
Console.WriteLine( "Char {0}", converted )
converted = Convert.ToString( TSpanA, provider )
Console.WriteLine( "TimeSpan {0}", converted )
converted = Convert.ToString( ObjOther, provider )
Console.WriteLine( "Object {0}", converted )
End Sub
End Module
' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
'
' System.Globalization.NumberFormatInfo Int32 -252645135
' System.Globalization.NumberFormatInfo Double 61680.3855
' System.Globalization.NumberFormatInfo Object -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
'
' Boolean True
' String Qwerty
' Char $
' TimeSpan 00:18:00
' Object DummyProvider
Comentários
Essa implementação é idêntica a Boolean.ToString .This implementation is identical to Boolean.ToString. Ele retorna Boolean.TrueString para true valores e Boolean.FalseString valores false .It returns Boolean.TrueString for true values and Boolean.FalseString for false values.
Aplica-se a
ToString(Int64)
Converte o valor do inteiro com sinal de 64 bits especificado em sua representação de cadeia de caracteres equivalente.Converts the value of the specified 64-bit signed integer to its equivalent string representation.
public:
static System::String ^ ToString(long value);
public static string ToString (long value);
static member ToString : int64 -> string
Public Shared Function ToString (value As Long) As String
Parâmetros
- value
- Int64
O inteiro com sinal de 64 bits a ser convertido.The 64-bit signed integer to convert.
Retornos
A representação da cadeia de caracteres de value.The string representation of value.
Exemplos
O exemplo a seguir converte cada elemento em uma matriz de inteiro longo em sua representação de cadeia de caracteres equivalente.The following example converts each element in a long integer array to its equivalent string representation.
// Create a NumberFormatInfo object and set several of its
// properties that control default integer formatting.
System.Globalization.NumberFormatInfo provider = new System.Globalization.NumberFormatInfo();
provider.NegativeSign = "minus ";
long[] values = { -200, 0, 1000 };
foreach (long value in values)
Console.WriteLine("{0,-6} --> {1,10}",
value, Convert.ToString(value, provider));
// The example displays the following output:
// -200 --> minus 200
// 0 --> 0
// 1000 --> 1000
' Create a NumberFormatInfo object and set several of its
' properties that control default integer formatting.
Dim provider As New System.Globalization.NumberFormatInfo()
provider.NegativeSign = "minus "
Dim values() As Long = { -200, 0, 1000 }
For Each value As Long In values
Console.WriteLine("{0,-6} --> {1,10}", _
value, Convert.ToString(value, provider))
Next
' The example displays the following output:
' -200 --> minus 200
' 0 --> 0
' 1000 --> 1000
Comentários
Essa implementação é idêntica a Int64.ToString() .This implementation is identical to Int64.ToString().