Int16.ToString Int16.ToString Int16.ToString Int16.ToString Method

Definizione

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.Converts the numeric value of this instance to its equivalent string representation.

Overload

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Consente di convertire il valore numerico dell'istanza corrente nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.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 string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parametri

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto IFormatProvider che fornisce informazioni di formattazione specifiche delle impostazioni cultura selezionate.An IFormatProvider that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da provider.The string representation of the value of this instance as specified by provider.

Implementazioni

Esempi

Nell'esempio seguente esegue l'iterazione di una matrice di Int16 i valori e ognuno di essi vengono visualizzati nella console chiamando il Int16.ToString(IFormatProvider) metodo con i provider di formato diverso.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. A causa della formattazione semplice definito dall'identificatore di formato "G" impostazione predefinita, le stringhe di formato generato per ogni Int16 sono identiche indipendentemente dal valore del valore di provider parametro.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)      

Commenti

Il ToString(IFormatProvider) formati del metodo un' Int16 valore il valore predefinito ("G" o generali) formato tramite il NumberFormatInfo oggetto delle impostazioni cultura specificata.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Se si desidera specificare le impostazioni cultura correnti o un formato diverso, usare gli altri overload del ToString (metodo), come indicato di seguito:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Per usare il formatoTo use format Per impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString()
Un formato specificoA specific format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString(String)
Un formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)

.NET Framework fornisce supporto di formattazione completo, che è descritti più dettagliatamente nella formattazione negli argomenti seguenti:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il provider parametro è un IFormatProvider implementazione cui IFormatProvider.GetFormat metodo restituisce un NumberFormatInfo oggetto.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. In genere provider è un NumberFormatInfo oggetto o un CultureInfo oggetto.Typically, provider is a NumberFormatInfo object or a CultureInfo object. Il NumberFormatInfo oggetto fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Se provider viene null, questa istanza viene formattata con il NumberFormatInfo oggetto per le impostazioni cultura correnti.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Vedi anche

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Consente di convertire il valore numerico dell'istanza corrente nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.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);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parametri

format
String String String String

Stringa di formato numerico.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.An object that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore dell'istanza corrente, in base a quanto specificato da format e provider.The string representation of the value of this instance as specified by format and provider.

Implementazioni

Esempi

L'esempio seguente mostra un Int16 valore utilizzando ognuna delle stringhe di formato standard supportate in quattro diverse impostazioni cultura.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  

Commenti

Il ToString(String, IFormatProvider) formati del metodo un' Int16 valore in un formato specificato utilizzando il NumberFormatInfo oggetto delle impostazioni cultura specificata.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Se si desidera usare le impostazioni di formato o le impostazioni cultura predefinite, usare gli altri overload del ToString (metodo), come indicato di seguito:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Per usare il formatoTo use format Per impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString()
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Un formato specificoA specific format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString(String)

Il format parametro può essere standard o una stringa di formato numerico personalizzato.The format parameter can be either a standard or a custom numeric format string. Sono supportate tutte le stringhe di formato numerico standard "R" (o "r"), così come tutti i caratteri di formato numerico personalizzato.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Se format è null o una stringa vuota (""), la stringa restituita da questo metodo viene formattata con l'identificatore di formato numerico standard ("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 Framework fornisce supporto di formattazione completo, che è descritti più dettagliatamente nella formattazione negli argomenti seguenti:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il provider parametro è un IFormatProvider implementazione.The provider parameter is an IFormatProvider implementation. Relativi GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Oggetto che implementa IFormatProvider può essere uno dei seguenti:The object that implements IFormatProvider can be any of the following:

  • Oggetto CultureInfo oggetto che rappresenta le impostazioni cultura le cui regole di formattazione da utilizzare.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Oggetto NumberFormatInfo oggetto che contiene specifiche informazioni sulla formattazione numeriche per questo valore.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Un oggetto personalizzato che implementa IFormatProvider.A custom object that implements IFormatProvider.

Se provider viene null, o una NumberFormatInfo oggetto non può essere ottenuto dal provider, il valore restituito viene formattato con il NumberFormatInfo per le impostazioni cultura correnti.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.

Vedi anche

ToString(String) ToString(String) ToString(String) ToString(String)

Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato.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);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parametri

format
String String String String

Stringa di formato numerico.A numeric format string.

Restituisce

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.The string representation of the value of this instance as specified by format.

Esempi

L'esempio seguente inizializza due Int16 valori e li visualizza nella console usando tutte le stringhe di formato standard supportate e diverse stringhe di formato personalizzato.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. Nell'esempio viene eseguito con en-US come impostazioni cultura correnti.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      

Commenti

Il ToString(String) formati del metodo un' Int16 valore in un formato specificato usando un NumberFormatInfo oggetto che rappresenta le convenzioni delle impostazioni cultura correnti.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. Se si desidera usare il valore predefinito ("G" o generali) formattare o specificare una lingua diversa, usare gli altri overload del ToString (metodo), come indicato di seguito: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:

Per usare il formatoTo use format Per impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString()
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Un formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)

Il format parametro può essere standard o una stringa di formato numerico personalizzato.The format parameter can be either a standard or a custom numeric format string. Sono supportate tutte le stringhe di formato numerico standard "R" (o "r"), così come tutti i caratteri di formato numerico personalizzato.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Se format è null o una stringa vuota, il valore restituito di questa istanza viene formattata con l'identificatore di formato numerico standard ("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 Framework fornisce supporto di formattazione completo, che è descritti più dettagliatamente nella formattazione negli argomenti seguenti:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il valore restituito di questa istanza viene formattato con il NumberFormatInfo per le impostazioni cultura correnti.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Vedi anche

ToString() ToString() ToString() ToString()

Converte il valore numerico dell'istanza nella rappresentazione di stringa 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

Restituisce

La rappresentazione di stringa del valore di questa istanza, composta dal segno meno (se il valore è negativo) e da una sequenza di cifre comprese tra 0 e 9 senza zeri iniziali.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.

Esempi

L'esempio seguente usa il ToString() metodo per visualizzare una matrice di Int16 valori nella console.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                             

Commenti

Il ToString() formati del metodo un' Int16 valore il valore predefinito ("G" o generali) formato tramite il NumberFormatInfo oggetto delle impostazioni cultura correnti.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Se si desidera specificare un formato diverso o delle impostazioni cultura, usare gli altri overload del ToString (metodo), come indicato di seguito:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Per usare il formatoTo use format Per impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Un formato specificoA specific format Impostazioni cultura (corrente) predefiniteDefault (current) culture ToString(String)
Un formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)

.NET Framework fornisce supporto di formattazione completo, che è descritti più dettagliatamente nella formattazione negli argomenti seguenti:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Vedi anche

Si applica a