Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Int64.ToString (String, IFormatProvider)

 

Data di pubblicazione: ottobre 2016

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public string ToString(
	string format,
	IFormatProvider provider
)

Parametri

format
Type: System.String

Stringa di formato numerico.

provider
Type: System.IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura relativamente all'istanza.

Valore restituito

Type: System.String

Rappresentazione di stringa del valore dell'istanza corrente, in base a quanto specificato da format e provider.

Exception Condition
FormatException

format non è valido o non è supportato.

Il ToString(String, IFormatProvider) formati del metodo un Int64 valore in un formato specificato utilizzando il NumberFormatInfo oggetto delle impostazioni cultura specificata. Se si desidera utilizzare le impostazioni di formato o delle impostazioni cultura predefinite, utilizzare gli altri overload di ToString (metodo), come indicato di seguito:

Per utilizzare formato

Per impostazioni cultura

Utilizzare l'overload

Formato predefinito ("G")

Impostazioni cultura predefinite del (corrente)

ToString()

Formato predefinito ("G")

Impostazioni cultura specifiche

ToString(IFormatProvider)

Un formato specifico

Impostazioni cultura predefinite del (corrente)

ToString(String)

Il format parametro può essere standard o una stringa di formato numerico personalizzate. Sono supportate tutte le stringhe di formato numerico standard "R" (o "r"), così come tutti i caratteri di formato numerico personalizzate. Se format è null o una stringa vuota (""), il valore restituito per questa istanza viene formattato con l'identificatore di formato numerico generale ("G").

Il provider parametro è un oggetto che implementa il IFormatProvider interfaccia. Il GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni specifiche delle impostazioni cultura sul formato della stringa restituita da questo metodo. Oggetto che implementa IFormatProvider può essere uno dei seguenti:

  • Oggetto CultureInfo oggetto che rappresenta le impostazioni cultura le cui regole di formattazione da utilizzare.

  • Oggetto NumberFormatInfo oggetto che contiene specifiche informazioni sulla formattazione numeriche per questo valore.

  • Un oggetto personalizzato che implementa IFormatProvider e il cui GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni di formattazione.

Se provider è null o NumberFormatInfo non può essere ottenuto dalla provider, il valore restituito per questa istanza viene formattato con il NumberFormatInfo per le impostazioni cultura correnti.

.NET Framework fornisce supporto di formattazione completo, descritto più dettagliatamente negli argomenti di formattazione seguenti:

L'esempio seguente mostra un numero positivo e un valore negativo utilizzando ognuno degli identificatori di formato numerico standard supportati per tre diverse impostazioni cultura.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"), 
                          CultureInfo.CreateSpecificCulture("fr-FR"), 
                          CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",  
                        specifier, culture.Name, 
                        positiveNumber.ToString(specifier, culture), 
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//    
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1�679,00 ?      -3�045,00 ?
//    C format using es-ES culture:       1.679,00 ?      -3.045,00 ?
//    
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//    
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//    
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//    
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1�679,00        -3�045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//    
//    P format using en-US culture:     167,900.00 %    -304,500.00 %
//    P format using fr-FR culture:     167�900,00 %    -304�500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//    
//    X8 format using en-US culture:         0000068F         FFFFF41B
//    X8 format using fr-FR culture:         0000068F         FFFFF41B
//    X8 format using es-ES culture:         0000068F         FFFFF41B

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: