Int16.ToString Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.
Overload
ToString() |
Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente. |
ToString(IFormatProvider) |
Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura. |
ToString(String) |
Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato. |
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. |
ToString()
- Origine:
- Int16.cs
- Origine:
- Int16.cs
- Origine:
- Int16.cs
Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.
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.
Esempio
Nell'esempio seguente viene utilizzato il ToString() metodo per visualizzare una matrice di Int16 valori nella 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
let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]
for number in numbers do
printfn $"{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() metodo formatta un Int16 valore nel formato predefinito ("G" o generale) usando l'oggetto NumberFormatInfo delle impostazioni cultura correnti. Se si desidera specificare un formato o impostazioni cultura diverse, usare gli altri overload del ToString metodo, come indicato di seguito:
Per usare il formato | Per le impostazioni cultura | Usare l'overload |
---|---|---|
Formato predefinito ("G") | Impostazioni cultura specifiche | ToString(IFormatProvider) |
Un formato specifico | Impostazioni cultura predefinite (correnti) | ToString(String) |
Un formato specifico | Impostazioni cultura specifiche | ToString(String, IFormatProvider) |
.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:
Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.
Vedi anche
Si applica a
ToString(IFormatProvider)
- Origine:
- Int16.cs
- Origine:
- Int16.cs
- Origine:
- Int16.cs
Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.
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
Parametri
- provider
- IFormatProvider
Oggetto IFormatProvider che fornisce informazioni di formattazione specifiche delle impostazioni cultura selezionate.
Restituisce
Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da provider
.
Implementazioni
Esempio
Nell'esempio seguente viene eseguita un'iterazione di una matrice di Int16 valori e ognuno di essi viene visualizzato nella console chiamando il Int16.ToString(IFormatProvider) metodo con provider di formato diversi. A causa della formattazione semplice definita dall'identificatore di formato "G" predefinito, le stringhe formattate prodotte per ogni Int16 valore sono identiche indipendentemente dal valore del provider
parametro.
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)
let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
for int16Value in numbers do
for provider in providers do
printf $"{int16Value.ToString provider, 6} ({provider.Name}) "
printfn ""
// 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) metodo formatta un Int16 valore nel formato predefinito ("G" o generale) usando l'oggetto NumberFormatInfo delle impostazioni cultura specificate. Se si desidera specificare un formato diverso o le impostazioni cultura correnti, usare gli altri overload del ToString metodo, come indicato di seguito:
Per usare il formato | Per le impostazioni cultura | Usare l'overload |
---|---|---|
Formato predefinito ("G") | Impostazioni cultura predefinite (correnti) | ToString() |
Un formato specifico | Impostazioni cultura predefinite (correnti) | ToString(String) |
Un formato specifico | Impostazioni cultura specifiche | ToString(String, IFormatProvider) |
.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:
Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.
Il provider
parametro è un'implementazione IFormatProvider il cui IFormatProvider.GetFormat metodo restituisce un NumberFormatInfo oggetto . In genere, provider
è un NumberFormatInfo oggetto o un CultureInfo oggetto . L'oggetto NumberFormatInfo fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo. Se provider
è null
, questa istanza viene formattata con l'oggetto NumberFormatInfo per le impostazioni cultura correnti.
Vedi anche
Si applica a
ToString(String)
- Origine:
- Int16.cs
- Origine:
- Int16.cs
- Origine:
- Int16.cs
Converte il valore numerico di questa istanza nell'equivalente rappresentazione di stringa usando il formato specificato.
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
Parametri
- format
- String
Stringa di formato numerico.
Restituisce
Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format
.
Esempio
L'esempio seguente inizializza due Int16 valori e li visualizza nella console usando ognuna delle stringhe di formato standard supportate e diverse stringhe di formato personalizzate. L'esempio viene eseguito con en-US come impostazioni cultura correnti.
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
let values = [| -23805s; 32194s |]
let formats =
[ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
printfn $"'{format,2}' format specifier: {values[0].ToString format,17} {values[1].ToString format,17}"
// 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) metodo formatta un Int16 valore in un formato specificato utilizzando un NumberFormatInfo oggetto che rappresenta le convenzioni delle impostazioni cultura correnti. Se si desidera usare il formato predefinito ("G" o generale) o specificare impostazioni cultura diverse, usare gli altri overload del ToString metodo, come indicato di seguito:
Per usare il formato | Per le impostazioni cultura | Usare l'overload |
---|---|---|
Formato predefinito ("G") | Impostazioni cultura predefinite (correnti) | ToString() |
Formato predefinito ("G") | Impostazioni cultura specifiche | ToString(IFormatProvider) |
Un formato specifico | Impostazioni cultura specifiche | ToString(String, IFormatProvider) |
Il format
parametro può essere una stringa di formato numerico standard o personalizzata. Tutte le stringhe di formato numerico standard diverse da "R" (o "r") sono supportate, come tutti i caratteri numerici personalizzati. Se format
è null
o una stringa vuota, il valore restituito di questa istanza viene formattato con l'identificatore di formato numerico generale ("G").
.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:
Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.
Il valore restituito di questa istanza viene formattato con per le NumberFormatInfo impostazioni cultura correnti.
Vedi anche
- Parse(String)
- String
- Formattazione di tipi in .NET
- Stringhe di formato numerico standard
- Stringhe di formato numerico personalizzato
- Procedura: aggiungere zeri iniziali a un numero
Si applica a
ToString(String, IFormatProvider)
- Origine:
- Int16.cs
- Origine:
- Int16.cs
- Origine:
- Int16.cs
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.
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
Parametri
- format
- String
Stringa di formato numerico.
- provider
- IFormatProvider
Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.
Restituisce
Rappresentazione di stringa del valore dell'istanza corrente, in base a quanto specificato da format
e provider
.
Implementazioni
Esempio
Nell'esempio seguente viene visualizzato un Int16 valore usando ognuna delle stringhe di formato standard supportate in quattro impostazioni cultura diverse.
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
let value = 14603
let formats =
[ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
// Display header.
printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
// Display a value using each format string.
for format in formats do
// Display the value for each provider on the same line.
printf $"{format,-12}"
for provider in providers do
printf $"{value.ToString(format, provider),12} "
printfn ""
// 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) metodo formatta un Int16 valore in un formato specificato utilizzando l'oggetto NumberFormatInfo di impostazioni cultura specificate. Se si desidera usare le impostazioni di formato o impostazioni cultura predefinite, usare gli altri overload del ToString metodo, come indicato di seguito:
Per usare il formato | Per le impostazioni cultura | Usare l'overload |
---|---|---|
Formato predefinito ("G") | Impostazioni cultura predefinite (correnti) | ToString() |
Formato predefinito ("G") | Impostazioni cultura specifiche | ToString(IFormatProvider) |
Un formato specifico | Impostazioni cultura predefinite (correnti) | ToString(String) |
Il format
parametro può essere una stringa di formato numerico standard o personalizzata. Tutte le stringhe di formato numerico standard diverse da "R" (o "r") sono supportate, come tutti i caratteri numerici personalizzati. Se format
è null
o una stringa vuota (""), la stringa restituita da questo metodo viene formattata con l'identificatore di formato numerico generale ("G").
.NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:
Per altre informazioni sugli identificatori di formato numerico, vedere Stringhe di formato numerico standard e stringhe di formato numerico personalizzato.
Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.
Il provider
parametro è un'implementazione IFormatProvider . Il GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo. L'oggetto che implementa IFormatProvider può essere uno dei seguenti:
Oggetto CultureInfo che rappresenta le impostazioni cultura le cui regole di formattazione devono essere usate.
Oggetto NumberFormatInfo che contiene informazioni di formattazione numerica specifiche per questo valore.
Oggetto personalizzato che implementa IFormatProvider.
Se provider
è null
o non è possibile ottenere un NumberFormatInfo oggetto da provider
, il valore restituito viene formattato con l'oggetto NumberFormatInfo per le impostazioni cultura correnti.
Vedi anche
- Parse(String)
- Formattazione di tipi in .NET
- Stringhe di formato numerico standard
- Stringhe di formato numerico personalizzate
- Procedura: aggiungere zeri iniziali a un numero
- Esempio: Utilità di formattazione di .NET Core WinForms (C#)
- Esempio: Utilità di formattazione di .NET Core WinForms (Visual Basic)