Ler en inglés

Compartir por


Convert.ToString Método

Definición

Convierte el valor especificado en su representación de cadena equivalente.

Sobrecargas

ToString(Int32, IFormatProvider)

Convierte el valor del entero de 32 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Int16, Int32)

Convierte el valor de un entero de 16 bits con signo en su representación de cadena equivalente en una base especificada.

ToString(DateTime, IFormatProvider)

Convierte el valor de la estructura DateTime especificada en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Double, IFormatProvider)

Convierte el valor del número de punto flotante de precisión doble especificado en la representación de cadena equivalente.

ToString(Decimal, IFormatProvider)

Convierte el valor del número decimal especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Int32, Int32)

Convierte el valor de un entero de 32 bits con signo en su representación de cadena equivalente en una base especificada.

ToString(Int16, IFormatProvider)

Convierte el valor del entero de 16 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Int64, IFormatProvider)

Convierte el valor del entero de 64 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Single, IFormatProvider)

Convierte el valor del número de punto flotante de precisión sencilla especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Object, IFormatProvider)

Convierte el valor del objeto especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(SByte, IFormatProvider)

Convierte el valor del entero de 8 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(String, IFormatProvider)

Devuelve la instancia de la cadena especificada; no se efectúa una conversión real.

ToString(UInt16, IFormatProvider)

Convierte el valor del entero de 16 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(UInt32, IFormatProvider)

Convierte el valor del entero de 32 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(UInt64, IFormatProvider)

Convierte el valor del entero de 64 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Char, IFormatProvider)

Convierte el valor del carácter Unicode especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Int64, Int32)

Convierte el valor de un entero de 64 bits con signo en su representación de cadena equivalente en una base especificada.

ToString(Byte, Int32)

Convierte el valor de un entero de 8 bits sin signo en su representación de cadena equivalente en una base especificada.

ToString(Boolean, IFormatProvider)

Convierte el valor booleano especificado en su representación de cadena equivalente.

ToString(Byte, IFormatProvider)

Convierte el valor del entero de 8 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

ToString(Boolean)

Convierte el valor booleano especificado en su representación de cadena equivalente.

ToString(Byte)

Convierte el valor del entero de 8 bits sin signo especificado en la representación de cadena equivalente.

ToString(Char)

Convierte el valor del carácter Unicode especificado en la representación de cadena equivalente.

ToString(DateTime)

Convierte el valor de la estructura DateTime especificada en su representación de cadena equivalente.

ToString(Double)

Convierte el valor del número de punto flotante de precisión doble especificado en la representación de cadena equivalente.

ToString(Int16)

Convierte el valor del entero de 16 bits con signo especificado en la representación de cadena equivalente.

ToString(Int32)

Convierte el valor del entero de 32 bits con signo especificado en la representación de cadena equivalente.

ToString(Decimal)

Convierte el valor de un número decimal especificado en su representación de cadena equivalente.

ToString(Object)

Convierte el valor del objeto especificado en su representación de cadena equivalente.

ToString(SByte)

Convierte el valor del entero de 8 bits con signo especificado en la representación de cadena equivalente.

ToString(Single)

Convierte el valor del número de punto flotante de precisión sencilla especificado en la representación de cadena equivalente.

ToString(String)

Devuelve la instancia de la cadena especificada; no se efectúa una conversión real.

ToString(UInt16)

Convierte el valor del entero de 16 bits sin signo especificado en la representación de cadena equivalente.

ToString(UInt32)

Convierte el valor del entero de 32 bits sin signo especificado en la representación de cadena equivalente.

ToString(UInt64)

Convierte el valor del entero de 64 bits sin signo especificado en la representación de cadena equivalente.

ToString(Int64)

Convierte el valor del entero de 64 bits con signo especificado en la representación de cadena equivalente.

ToString(Int32, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 32 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (int value, IFormatProvider provider);
C#
public static string ToString (int value, IFormatProvider? provider);

Parámetros

value
Int32

Entero de 32 bits con signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(Int32, IFormatProvider) método para convertir cada elemento en una matriz de enteros en su representación de cadena equivalente. La conversión usa la referencia cultural invariable, así como el objeto personalizado NumberFormatInfo .

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

Comentarios

Esta implementación es idéntica a Int32.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int16, Int32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de un entero de 16 bits con signo en su representación de cadena equivalente en una base especificada.

C#
public static string ToString (short value, int toBase);

Parámetros

value
Int16

Entero de 16 bits con signo que se va a convertir.

toBase
Int32

Base del valor devuelto, que debe ser 2, 8, 10 ó 16.

Devoluciones

Representación de cadena de value en la base toBase.

Excepciones

toBase no es 2, 8, 10 o 16.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros con signo de 16 bits en sus representaciones de cadena binarias, octales, decimales y hexadecimales equivalentes.

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

Comentarios

Si value es positivo y toBase es 2, 8 o 16, la cadena devuelta usa la representación de signo y magnitud. Si value es negativo y toBase es 2, 8 o 16, la cadena devuelta usa la representación complementaria de dos. Esto significa que el bit de orden alto del byte de orden alto (bit 15) se interpreta como bit de signo. ToString(Int16, Int32) Si se llama al método para crear una cadena que se convertirá más adelante en un número, se debe llamar a un método correspondiente que supone que se debe llamar a una representación numérica similar para realizar la conversión. Estos métodos incluyen Convert.ToInt16(String, Int32) y Int16.Parse(String, NumberStyles).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(DateTime, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de la estructura DateTime especificada en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (DateTime value, IFormatProvider provider);
C#
public static string ToString (DateTime value, IFormatProvider? provider);

Parámetros

value
DateTime

Valor de fecha y hora que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un DateTime valor en su representación de cadena equivalente en ocho referencias culturales diferentes.

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

Comentarios

Esta implementación es idéntica a DateTime.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Double, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del número de punto flotante de precisión doble especificado en la representación de cadena equivalente.

C#
public static string ToString (double value, IFormatProvider provider);
C#
public static string ToString (double value, IFormatProvider? provider);

Parámetros

value
Double

Número de punto flotante de precisión doble que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de Double valores en su representación de cadena equivalente en cuatro referencias culturales diferentes.

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

Comentarios

Esta implementación es idéntica a Double.ToString(IFormatProvider)

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Decimal, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del número decimal especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (decimal value, IFormatProvider provider);
C#
public static string ToString (decimal value, IFormatProvider? provider);

Parámetros

value
Decimal

Número decimal que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de Decimal valores en su representación de cadena equivalente en cuatro referencias culturales diferentes.

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

Comentarios

Esta implementación es idéntica a Decimal.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int32, Int32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de un entero de 32 bits con signo en su representación de cadena equivalente en una base especificada.

C#
public static string ToString (int value, int toBase);

Parámetros

value
Int32

Entero de 32 bits con signo que se va a convertir.

toBase
Int32

Base del valor devuelto, que debe ser 2, 8, 10 ó 16.

Devoluciones

Representación de cadena de value en la base toBase.

Excepciones

toBase no es 2, 8, 10 o 16.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros en sus representaciones de cadena binarias, hexadecimales, decimales y hexadecimales equivalentes.

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

Comentarios

Si value es positivo y toBase es 2, 8 o 16, la cadena devuelta usa la representación de signo y magnitud. Si value es negativo y toBase es 2, 8 o 16, la cadena devuelta usa la representación complementaria de dos. Esto significa que el bit de orden superior del byte de orden más alto (bit 31) se interpreta como bit de signo. Si se llama al ToString(Int32, Int32) método para crear una cadena que se convertirá más adelante en un número, se debe llamar a un método correspondiente que supone que se debe llamar a una representación numérica similar para realizar la conversión. Estos métodos incluyen Convert.ToInt32(String, Int32) y Int32.Parse(String, NumberStyles).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int16, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 16 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (short value, IFormatProvider provider);
C#
public static string ToString (short value, IFormatProvider? provider);

Parámetros

value
Int16

Entero de 16 bits con signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(Int16, IFormatProvider) método para convertir cada elemento de una matriz de enteros de 16 bits en su representación de cadena equivalente. La conversión usa la referencia cultural invariable, así como el objeto personalizado NumberFormatInfo .

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

Comentarios

Esta implementación es idéntica a Int16.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int64, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 64 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (long value, IFormatProvider provider);
C#
public static string ToString (long value, IFormatProvider? provider);

Parámetros

value
Int64

Entero de 64 bits con signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(Int64, IFormatProvider) método para convertir cada elemento de una matriz de enteros largo en su representación de cadena equivalente. La conversión usa la referencia cultural invariable, así como el objeto personalizado NumberFormatInfo .

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

Comentarios

Esta implementación es idéntica a Int64.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Single, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del número de punto flotante de precisión sencilla especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (float value, IFormatProvider provider);
C#
public static string ToString (float value, IFormatProvider? provider);

Parámetros

value
Single

Número de punto flotante de precisión sencilla que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de Single valores en su representación de cadena equivalente en cuatro referencias culturales diferentes.

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

Comentarios

Esta implementación es idéntica a Single.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Object, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del objeto especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (object value, IFormatProvider provider);
C#
public static string? ToString (object? value, IFormatProvider? provider);

Parámetros

value
Object

Objeto que proporciona el valor que se va a convertir, o null.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

La representación de cadena de value, o Empty si value es un objeto cuyo valor es null. Si el valor de value es null, el método devuelve null.

Ejemplos

En el ejemplo siguiente se define una Temperature clase que invalida el Object.ToString método pero no implementa la IConvertible interfaz . En el ejemplo se muestra cómo las llamadas al Convert.ToString(Object, IFormatProvider) método, a su vez, llaman al Temperature.ToString método .

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

En el ejemplo siguiente se define una Temperature clase que implementa la IFormattable interfaz, pero que no implementa la IConvertible interfaz . Su IFormattable.ToString implementación representa el Temperature valor en Celsius, Fahrenheit o Kelvin, dependiendo de la cadena de formato. En el ejemplo también se define una TemperatureProvider clase que implementa IFormatProvider y proporciona una cadena de formato generada aleatoriamente que se usa en la IFormattable implementación de la Temperature clase .

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

Comentarios

Si el value parámetro implementa la IConvertible interfaz , el método llama a la IConvertible.ToString(IFormatProvider) implementación de value. De lo contrario, si el value parámetro implementa la IFormattable interfaz , el método llama a su IFormattable.ToString(String, IFormatProvider) implementación. Si value no implementa ninguna interfaz, el método llama al value método del ToString() parámetro y se omite el provider parámetro .

El provider parámetro se usa si el value parámetro implementa la IConvertible interfaz o IFormattable . El uso más común del provider parámetro es especificar información específica de la referencia cultural utilizada en la conversión de value. Por ejemplo, si el value parámetro es un número decimal negativo, el provider parámetro puede proporcionar información específica de la referencia cultural sobre la notación utilizada para el signo negativo y el separador decimal. En el segundo ejemplo de la sección siguiente se muestra un proveedor de formato que no proporciona información de formato confidencial a la referencia cultural.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(SByte, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 8 bits con signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider provider);
C#
[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider? provider);

Parámetros

value
SByte

Entero de 8 bits con signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al Convert.ToString(SByte, IFormatProvider) método para convertir cada elemento de la matriz de bytes con signo en su representación de cadena equivalente. La conversión usa la referencia cultural invariable, así como el objeto personalizado NumberFormatInfo .

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

Comentarios

Esta implementación es idéntica a SByte.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Devuelve la instancia de la cadena especificada; no se efectúa una conversión real.

C#
public static string? ToString (string? value, IFormatProvider? provider);
C#
public static string ToString (string value, IFormatProvider provider);

Parámetros

value
String

Cadena que se va a devolver.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural. Este parámetro se ignora.

Devoluciones

value se devuelve sin cambios.

Ejemplos

En el ejemplo siguiente se llama al ToString método con un String parámetro . El método devuelve el no modificado String sin hacer referencia al IFormatProvider objeto .

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

*/

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToString(UInt16, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 16 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider provider);
C#
[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider? provider);

Parámetros

value
UInt16

Entero de 16 bits sin signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(UInt16, IFormatProvider) método para convertir un valor entero de 16 bits sin signo en su representación de cadena equivalente. La conversión usa la referencia cultural invariable y el objeto personalizado NumberFormatInfo . La salida indica que no se usa esta información de formato, porque de forma predeterminada el especificador de formato "G" no incluye un signo positivo con valores positivos.

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

Comentarios

Esta implementación es idéntica a UInt16.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(UInt32, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 32 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider provider);
C#
[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider? provider);

Parámetros

value
UInt32

Entero de 32 bits sin signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(UInt32, IFormatProvider) método para convertir un valor entero sin signo en su representación de cadena equivalente. La conversión usa la referencia cultural invariable y el objeto personalizado NumberFormatInfo . La salida indica que no se usa esta información de formato, porque de forma predeterminada el especificador de formato "G" no incluye un signo positivo con valores positivos.

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

Comentarios

Esta implementación es idéntica a UInt32.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(UInt64, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 64 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider provider);
C#
[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider? provider);

Parámetros

value
UInt64

Entero de 64 bits sin signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se define una clase personalizada NumberFormatInfo que define su signo negativo como la cadena "~" y su signo positivo como la cadena "!". A continuación, llama al ToString(UInt64, IFormatProvider) método para convertir un valor entero largo sin signo en su representación de cadena equivalente. La conversión usa la referencia cultural invariable y el objeto personalizado NumberFormatInfo . La salida indica que esta información de formato no se usa, porque de forma predeterminada el especificador de formato "G" no incluye un signo positivo con valores positivos.

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

Comentarios

Esta implementación es idéntica a UInt64.ToString(IFormatProvider).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Char, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del carácter Unicode especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (char value, IFormatProvider provider);
C#
public static string ToString (char value, IFormatProvider? provider);

Parámetros

value
Char

Carácter Unicode que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural. Este parámetro se ignora.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un Char valor en String con el ToString método , utilizando un IFormatProvider objeto que muestra el tipo del proveedor de formato para el que se llama. En el ejemplo se muestra que no se hace referencia al IFormatProvider objeto .

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

*/

Comentarios

Esta implementación es idéntica a Char.ToString(). Se omite el parámetro provider.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int64, Int32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de un entero de 64 bits con signo en su representación de cadena equivalente en una base especificada.

C#
public static string ToString (long value, int toBase);

Parámetros

value
Int64

Entero de 64 bits con signo que se va a convertir.

toBase
Int32

Base del valor devuelto, que debe ser 2, 8, 10 ó 16.

Devoluciones

Representación de cadena de value en la base toBase.

Excepciones

toBase no es 2, 8, 10 o 16.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros largo en sus representaciones de cadena binarias, hexadecimales, decimales y hexadecimales equivalentes.

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

Comentarios

Si value es positivo y toBase no es 10, la cadena devuelta usa la representación de signo y magnitud. Si value es negativo y toBase no es 10, la cadena devuelta usa la representación complementaria de dos. Esto significa que el bit de orden superior del byte de orden más alto (bit 63) se interpreta como bit de signo. ToString(Int64, Int32) Si se llama al método para crear una cadena que se convertirá más adelante en un número, se debe llamar a un método correspondiente que supone que se debe llamar a una representación numérica similar para realizar la conversión. Estos métodos incluyen Convert.ToInt64(String, Int32) y Int64.Parse(String, NumberStyles).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Byte, Int32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de un entero de 8 bits sin signo en su representación de cadena equivalente en una base especificada.

C#
public static string ToString (byte value, int toBase);

Parámetros

value
Byte

Entero de 8 bits sin signo que se va a convertir.

toBase
Int32

Base del valor devuelto, que debe ser 2, 8, 10 ó 16.

Devoluciones

Representación de cadena de value en la base toBase.

Excepciones

toBase no es 2, 8, 10 o 16.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de bytes en sus representaciones de cadena binarias, hexadecimales, decimales y hexadecimales equivalentes.

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

Comentarios

Si toBase no es igual a 10, la cadena devuelta por el Convert.ToString(Byte, Int32) método representa value solo por su magnitud. Si se llama al método para crear una cadena que se convertirá más adelante en un número, se debe llamar a un método correspondiente que supone que se debe llamar a una representación numérica de solo magnitud para realizar la conversión. Estos métodos incluyen Convert.ToByte(String, Int32) o Byte.Parse(String, NumberStyles).

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Boolean, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor booleano especificado en su representación de cadena equivalente.

C#
public static string ToString (bool value, IFormatProvider provider);
C#
public static string ToString (bool value, IFormatProvider? provider);

Parámetros

value
Boolean

Valor booleano que se va a convertir.

provider
IFormatProvider

Una instancia de un objeto. Este parámetro se ignora.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un Boolean valor en String con el ToString método , utilizando un IFormatProvider objeto que muestra el tipo del proveedor de formato para el que se llama. En el ejemplo se muestra que no se hace referencia al IFormatProvider objeto .

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

*/

Comentarios

Esta implementación es idéntica a Boolean.ToString. Boolean.TrueString Devuelve los true valores y Boolean.FalseString para false los valores.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Byte, IFormatProvider)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 8 bits sin signo especificado en su representación de cadena equivalente, usando la información de formato específica de la referencia cultural indicada.

C#
public static string ToString (byte value, IFormatProvider provider);
C#
public static string ToString (byte value, IFormatProvider? provider);

Parámetros

value
Byte

Entero de 8 bits sin signo que se va a convertir.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de bytes sin signo en su representación de cadena equivalente mediante las convenciones de formato de las referencias culturales en-US y fr-FR. Dado que el especificador "G" genera de forma predeterminada solo dígitos decimales en la representación de cadena de un valor de byte, el provider parámetro no afecta al formato de la cadena devuelta.

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

Comentarios

Esta implementación es idéntica a Byte.ToString.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Boolean)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor booleano especificado en su representación de cadena equivalente.

C#
public static string ToString (bool value);

Parámetros

value
Boolean

Valor booleano que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se muestra la conversión de a Boolean , Stringmediante ToString. También muestra que la cadena devuelta por la conversión es igual Boolean.TrueString a o Boolean.FalseString.

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

Comentarios

Esta implementación es idéntica a Boolean.ToString. Boolean.TrueString Devuelve los true valores y Boolean.FalseString para false los valores.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Byte)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 8 bits sin signo especificado en la representación de cadena equivalente.

C#
public static string ToString (byte value);

Parámetros

value
Byte

Entero de 8 bits sin signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada valor de una Byte matriz en una cadena.

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

Comentarios

Esta implementación es idéntica a Byte.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Char)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del carácter Unicode especificado en la representación de cadena equivalente.

C#
public static string ToString (char value);

Parámetros

value
Char

Carácter Unicode que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un Char objeto en .String

C#
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);
}

Comentarios

Esta implementación es idéntica a Char.ToString.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(DateTime)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de la estructura DateTime especificada en su representación de cadena equivalente.

C#
public static string ToString (DateTime value);

Parámetros

value
DateTime

Valor de fecha y hora que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de un DateTime valor en un String valor .

C#
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.

Comentarios

Esta implementación es idéntica a DateTime.ToString(). Usa las convenciones de formato de la referencia cultural actual y el especificador de formato "G" para convertir un DateTime valor en su representación de cadena.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Double)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del número de punto flotante de precisión doble especificado en la representación de cadena equivalente.

C#
public static string ToString (double value);

Parámetros

value
Double

Número de punto flotante de precisión doble que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un Double objeto en .String

C#
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.");
    }
}

Comentarios

Esta implementación es idéntica a Double.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int16)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 16 bits con signo especificado en la representación de cadena equivalente.

C#
public static string ToString (short value);

Parámetros

value
Int16

Entero de 16 bits con signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros de 16 bits en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a Int16.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 32 bits con signo especificado en la representación de cadena equivalente.

C#
public static string ToString (int value);

Parámetros

value
Int32

Entero de 32 bits con signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se compara el ToString(Int32) método con el ToString(UInt16, IFormatProvider) método . Define un objeto personalizado NumberFormatInfo que usa el sting "menos" para representar el signo negativo. Convierte cada elemento de una matriz de enteros en su representación de cadena equivalente mediante el formato predeterminado (las convenciones de formato de la referencia cultural actual) y el proveedor de formato personalizado.

C#
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
   }
}

Comentarios

Esta implementación es idéntica a Int32.ToString(). Da formato value mediante las convenciones de formato de la referencia cultural actual.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Decimal)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor de un número decimal especificado en su representación de cadena equivalente.

C#
public static string ToString (decimal value);

Parámetros

value
Decimal

Número decimal que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte un Decimal objeto en .String

C#
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);
}

Comentarios

Esta implementación es idéntica a Decimal.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Object)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del objeto especificado en su representación de cadena equivalente.

C#
public static string ToString (object value);
C#
public static string? ToString (object? value);

Parámetros

value
Object

Objeto que proporciona el valor que se va a convertir, o null.

Devoluciones

Representación de cadena de value o Empty si value es null.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de objetos en su representación de cadena equivalente.

C#
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.

Comentarios

Para convertir value en su representación de cadena, el método intenta llamar a la IConvertible.ToString implementación de value. Si value no implementa la IConvertible interfaz , el método intenta llamar a la IFormattable.ToString implementación de value. Si value no implementa la IFormattable interfaz , el método llama al ToString método del tipo subyacente de value.

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(SByte)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 8 bits con signo especificado en la representación de cadena equivalente.

C#
[System.CLSCompliant(false)]
public static string ToString (sbyte value);

Parámetros

value
SByte

Entero de 8 bits con signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de bytes con signo en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a SByte.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Single)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del número de punto flotante de precisión sencilla especificado en la representación de cadena equivalente.

C#
public static string ToString (float value);

Parámetros

value
Single

Número de punto flotante de precisión sencilla que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de Single valores en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a Single.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Devuelve la instancia de la cadena especificada; no se efectúa una conversión real.

C#
public static string? ToString (string? value);
C#
public static string ToString (string value);

Parámetros

value
String

Cadena que se va a devolver.

Devoluciones

value se devuelve sin cambios.

Ejemplos

En el ToString(String) ejemplo siguiente se pasa una cadena al método y se llama al Object.ReferenceEquals método para confirmar que el método devuelve la cadena original. En el ejemplo también se llama al String.IsInterned método para asegurarse de que las dos cadenas no son idénticas porque la cadena original está internada.

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

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToString(UInt16)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 16 bits sin signo especificado en la representación de cadena equivalente.

C#
[System.CLSCompliant(false)]
public static string ToString (ushort value);

Parámetros

value
UInt16

Entero de 16 bits sin signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de valores enteros de 16 bits sin signo en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a UInt16.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(UInt32)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 32 bits sin signo especificado en la representación de cadena equivalente.

C#
[System.CLSCompliant(false)]
public static string ToString (uint value);

Parámetros

value
UInt32

Entero de 32 bits sin signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros sin signo en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a UInt32.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(UInt64)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor del entero de 64 bits sin signo especificado en la representación de cadena equivalente.

C#
[System.CLSCompliant(false)]
public static string ToString (ulong value);

Parámetros

value
UInt64

Entero de 64 bits sin signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Atributos

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros largos sin signo en su representación de cadena equivalente.

C#
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.

Comentarios

Esta implementación es idéntica a UInt64.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(Int64)

Source:
Convert.cs
Source:
Convert.cs
Source:
Convert.cs

Convierte el valor del entero de 64 bits con signo especificado en la representación de cadena equivalente.

C#
public static string ToString (long value);

Parámetros

value
Int64

Entero de 64 bits con signo que se va a convertir.

Devoluciones

Representación de cadena de value.

Ejemplos

En el ejemplo siguiente se convierte cada elemento de una matriz de enteros largo en su representación de cadena equivalente.

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

Comentarios

Esta implementación es idéntica a Int64.ToString().

Se aplica a

.NET 9 e outras versións
Produto Versións
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0