Int16.ToString Método

Definición

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

Sobrecargas

ToString(IFormatProvider)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente utilizando el formato y la información de formato específica de la referencia cultural especificados.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parámetros

provider
IFormatProvider

Un IFormatProvider que proporciona información de formato específica de la referencia cultural.An IFormatProvider that supplies culture-specific formatting information.

Devoluciones

String

Representación en forma de cadena del valor de esta instancia, tal y como especifica provider.The string representation of the value of this instance as specified by provider.

Implementaciones

Ejemplos

En el ejemplo siguiente se recorre en iteración una matriz de Int16 valores y se muestra cada uno de ellos en la consola llamando al Int16.ToString(IFormatProvider) método con distintos proveedores de formato.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. Debido al formato simple definido por el especificador de formato "G" predeterminado, las cadenas con formato generadas para cada Int16 valor son idénticas, independientemente del valor del provider parámetro.Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ",
                    int16Value.ToString(provider),
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      

Comentarios

El ToString(IFormatProvider) método da formato Int16 a un valor en el formato predeterminado ("G" o general) mediante el NumberFormatInfo objeto de una referencia cultural especificada.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Si desea especificar un formato diferente o la referencia cultural actual, use las otras sobrecargas del ToString método, como se indica a continuación:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

.NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El provider parámetro es una IFormatProvider implementación cuyo IFormatProvider.GetFormat método devuelve un NumberFormatInfo objeto.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Normalmente, provider es un NumberFormatInfo objeto o un CultureInfo objeto.Typically, provider is a NumberFormatInfo object or a CultureInfo object. El NumberFormatInfo objeto proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Si provider es null , se da formato a esta instancia con el NumberFormatInfo objeto de la referencia cultural actual.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Consulte también

Se aplica a

ToString(String, IFormatProvider)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente utilizando el formato y la información de formato específica de la referencia cultural especificados.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parámetros

format
String

Cadena de formato numérico.A numeric format string.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

String

Representación de cadena del valor de esta instancia, tal y como especifican format y provider.The string representation of the value of this instance as specified by format and provider.

Implementaciones

Ejemplos

En el ejemplo siguiente se muestra un Int16 valor mediante cada una de las cadenas de formato estándar admitidas en cuatro referencias culturales diferentes.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ",
                    value.ToString(format, provider));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €
//    D6                014603        014603        014603        014603
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004
//    F1               14603.0       14603,0       14603,0       14603,0
//    G                  14603         14603         14603         14603
//    N1              14,603.0      14 603,0      14.603,0      14.603,0
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %
//    X4                  390B          390B          390B          390B
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000
//    ##000.0          14603.0       14603,0       14603,0       14603,0
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0  

Comentarios

El ToString(String, IFormatProvider) método da formato a un Int16 valor en un formato especificado mediante el NumberFormatInfo objeto de una referencia cultural especificada.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Si desea utilizar el formato predeterminado o la configuración de referencia cultural, utilice las otras sobrecargas del ToString método, como se indica a continuación:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)

El format parámetro puede ser una cadena de formato numérico estándar o personalizada.The format parameter can be either a standard or a custom numeric format string. Se admiten todas las cadenas de formato numérico estándar distintas de "R" (o "r"), al igual que todos los caracteres de formato numérico personalizado.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Si format es null o una cadena vacía (""), la cadena devuelta por este método tiene el formato del especificador de formato numérico general ("G").If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

.NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El provider parámetro es una IFormatProvider implementación de.The provider parameter is an IFormatProvider implementation. Su GetFormat método devuelve un NumberFormatInfo objeto que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. El objeto que implementa IFormatProvider puede ser cualquiera de los siguientes:The object that implements IFormatProvider can be any of the following:

  • CultureInfoObjeto que representa la referencia cultural cuyas reglas de formato se van a utilizar.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfoObjeto que contiene información de formato numérico específica para este valor.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Objeto personalizado que implementa IFormatProvider .A custom object that implements IFormatProvider.

Si provider es null , o NumberFormatInfo no se puede obtener un objeto de provider , el valor devuelto se formatea con NumberFormatInfo para la referencia cultural actual.If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for the current culture.

Consulte también

Se aplica a

ToString(String)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parámetros

format
String

Cadena de formato numérico.A numeric format string.

Devoluciones

String

Representación en forma de cadena del valor de esta instancia, tal y como especifica format.The string representation of the value of this instance as specified by format.

Ejemplos

En el ejemplo siguiente se inicializan dos Int16 valores y se muestran en la consola utilizando cada una de las cadenas de formato estándar admitidas y varias cadenas de formato personalizado.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. El ejemplo se ejecuta con en-US como referencia cultural actual.The example is run with en-US as the current culture.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",
                     format,
                     values[0].ToString(format),
                     values[1].ToString(format));
}
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0      

Comentarios

El ToString(String) método da formato a un Int16 valor en un formato especificado mediante un NumberFormatInfo objeto que representa las convenciones de la referencia cultural actual.The ToString(String) method formats an Int16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Si desea utilizar el formato predeterminado ("G" o general) o especificar una referencia cultural diferente, use las otras sobrecargas del ToString método, como se indica a continuación:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El format parámetro puede ser una cadena de formato numérico estándar o personalizada.The format parameter can be either a standard or a custom numeric format string. Se admiten todas las cadenas de formato numérico estándar distintas de "R" (o "r"), al igual que todos los caracteres de formato numérico personalizado.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Si format es null o una cadena vacía, el valor devuelto de esta instancia se formatea con el especificador de formato numérico general ("G").If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

.NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El valor devuelto de esta instancia tiene el formato NumberFormatInfo de para la referencia cultural actual.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Consulte también

Se aplica a

ToString()

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Devoluciones

String

Representación en forma de cadena del valor de esta instancia, que consta de un signo menos si el valor es negativo y una secuencia de dígitos que comprende del 0 al 9 sin ceros a la izquierda.The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Ejemplos

En el ejemplo siguiente se usa el ToString() método para mostrar una matriz de Int16 valores en la consola.The following example uses the ToString() method to display an array of Int16 values to the console.

short[] numbers = {0, 14624, 13982, short.MaxValue,
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667                             

Comentarios

El ToString() método da formato Int16 a un valor en el formato predeterminado ("G" o general) utilizando el NumberFormatInfo objeto de la referencia cultural actual.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Si desea especificar un formato o una referencia cultural diferente, use las otras sobrecargas del ToString método, como se indica a continuación:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

.NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Consulte también

Se aplica a