Formattazione di dati numerici per specifiche impostazioni cultura
La classe NumberFormatInfo definisce la modalità di formattazione e visualizzazione della valuta, dei separatori decimali e di altri simboli numerici in base alle impostazioni cultura. Ad esempio, il numero decimale 10000.50 viene formattato come 10,000.50 per le impostazioni cultura relative alla lingua inglese parlata negli Stati Uniti ("en-US") e come 10.000,50 per le impostazioni cultura relative alla lingua tedesca parlata in Germania ("de-DE").
Un oggetto NumberFormatInfo può essere creato per impostazioni cultura specifiche oppure per la lingua inglese, ma non per impostazioni cultura non associate ad alcun paese. Le impostazioni cultura non associate ad alcun paese non forniscono informazioni sufficienti per visualizzare il formato numerico corretto. Se l'applicazione tenta di creare un oggetto NumberFormatInfo utilizzando impostazioni cultura non associate ad alcun paese, viene generata un'eccezione.
Nell'esempio di codice riportato di seguito viene visualizzato un numero intero utilizzando il formato di valuta standard NumberFormatInfo ("c") per le impostazioni cultura correnti.
Imports System
Imports System.Globalization
Public Class TestClass
Public Shared Sub Main()
Dim i As Integer = 100
' Creates a CultureInfo for English in Belize.
Dim bz As New CultureInfo("en-BZ")
' Displays i formatted as currency for the bz.
Console.WriteLine(i.ToString("c", bz))
' Creates a CultureInfo for English in the U.S.
Dim us As New CultureInfo("en-US")
' Displays i formatted as currency for us.
Console.WriteLine(i.ToString("c", us))
' Creates a CultureInfo for Danish in Denmark.
Dim dk As New CultureInfo("da-DK")
' Displays i formatted as currency for dk.
Console.WriteLine(i.ToString("c", dk))
End Sub
End Class
using System;
using System.Globalization;
public class TestClass
{
public static void Main()
{
int i = 100;
// Creates a CultureInfo for English in Belize.
CultureInfo bz = new CultureInfo("en-BZ");
// Displays i formatted as currency for the bz.
Console.WriteLine(i.ToString("c", bz));
// Creates a CultureInfo for English in the U.S.
CultureInfo us = new CultureInfo("en-US");
// Display i formatted as currency for us.
Console.WriteLine(i.ToString("c", us));
// Creates a CultureInfo for Danish in Denmark.
CultureInfo dk = new CultureInfo("da-DK");
// Displays i formatted as currency for dk.
Console.WriteLine(i.ToString("c", dk));
}
}
L'output del codice è il seguente:
BZ$100.00
$100.00
kr100,00
Formattazione della valuta per i paesi dell'euro
Entrambe le classi CultureInfo e RegionInfo contengono informazioni sulla valuta. Viene specificata una sola valuta per impostazioni cultura. L'euro è la valuta ufficiale di Belgio, Germania, Spagna, Francia, Irlanda, Italia, Lussemburgo, Paesi Bassi, Austria, Portogallo, Finlandia e Grecia. Il 1 gennaio 2002 questi paesi hanno iniziato a utilizzare banconote e monete in euro. Per questi dodici paesi, in .NET Framework e Microsoft Windows XP il simbolo di valuta predefinito viene quindi impostato sull'euro. Nelle versioni precedenti di Windows, il simbolo di valuta predefinito sarà ancora impostato sul simbolo della valuta locale di questi paesi.
È necessario tenere presenti le differenze tra i sistemi operativi in merito ai simboli di valuta predefiniti. In Windows gli utenti sono in grado di eseguire l'override di alcuni valori associati alle impostazioni cultura predefinite del sistema operativo mediante le opzioni internazionali e della lingua nel Pannello di controllo. Un utente, ad esempio, può scegliere di visualizzare la valuta utilizzando un simbolo diverso da quello predefinito per le impostazioni cultura. In Windows Form e nelle applicazioni console viene utilizzato il simbolo di valuta predefinito specificato nel sistema operativo. Se un utente residente in un paese che adotta l'euro utilizza una versione precedente di Windows in cui l'impostazione della valuta sull'euro non è stata aggiornata mediante le impostazioni internazionali e della lingua nel Pannello di controllo, disporrà di un'impostazione di valuta predefinita non corretta. Le applicazioni ASP.NET e le applicazioni di servizi Web XML create in ASP.NET vengono eseguite come servizi di sistema, non per utenti specifici. I risultati predefiniti restituiti possono quindi differire da quelli restituiti da Windows Form e dalle applicazioni console.
È consigliabile scrivere codice che utilizza le impostazioni di valuta predefinite di .NET Framework per determinate impostazioni cultura, in modo da proteggere l'applicazione dalle differenze esistenti nei sistemi operativi e garantire una formattazione della valuta uniforme. L'applicazione deve creare un oggetto CultureInfo utilizzando uno degli overload del costruttore che accetta il parametro useUserOverride e impostare tale parametro su false. In questo modo verrà eseguito l'override dell'impostazione di valuta predefinita nel sistema operativo con l'impostazione predefinita corretta di .NET Framework.
Nel codice dei servizi Web XML riportato di seguito viene illustrato come il metodo del servizio Web XML UserLocalSetting imposta la proprietà CurrentCulture sulle impostazioni cultura relative alla lingua francese parlata in Francia ("fr-FR") e recupera un numero intero formattato come valuta. A causa delle differenze tra i sistemi operativi, non è possibile essere certi se verrà utilizzato il simbolo dell'euro o il simbolo "F". Il metodo del server Web XML OverrideUserSetting imposta la proprietà CurrentCulture su "fr-FR" utilizzando il costruttore CultureInfo che accetta un parametro useUserOverride impostato su false. Il metodo recupera un numero intero formattato come valuta. In tal caso il simbolo dell'euro viene sicuramente utilizzato in quanto valore predefinito di .NET Framework.
<%@ WebService Language="VB" Class="userOverrideSample" %>
Imports System
Imports System.Web.Services
Imports System.Globalization
Imports System.Threading
Public Class userOverrideSample
<WebMethod> _
Public Function UserLocalSetting() As String
Dim i As Integer = 100
' Sets the CurrentCulture to French in France.
Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-FR")
' Displays i formatted as currency for the CurrentCulture.
' Due to operating system differences, you cannot be sure what currency
' symbol will be used.
return (i.ToString("c"))
End Function
<WebMethod> _
Public Function OverrideUserSetting() As String
Dim i As Integer = 100
' Sets the CurrentCulture to French in France.
' Uses the CultureInfo constructor that takes a
' useUserOverride parameter.
' Sets the useUserOverride value to false.
Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-FR", _
false)
' Displays i formatted as currency for the CurrentCulture.
' This will override any user settings and display the euro symbol.
return (i.ToString("c"))
End Function
End Class
<%@ WebService Language="c#" Class="userOverrideSample" %>
using System;
using System.Web.Services;
using System.Globalization;
using System.Threading;
public class userOverrideSample
{
[WebMethod]
public String UserLocalSetting()
{
int i = 100;
// Sets the CurrentCulture to French in France.
Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");
// Displays i formatted as currency for the CurrentCulture.
// Due to operating system differences, you cannot be sure what currency
// symbol will be used.
return (i.ToString("c"));
}
[WebMethod]
public String OverrideUserSetting()
{
int i = 100;
// Sets the CurrentCulture to French in France.
// Uses the CultureInfo constructor that takes a
// useUserOverride parameter.
// Sets the useUserOverride value to false.
Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR", _
false);
// Displays i formatted as currency for the CurrentCulture.
// This will override any user settings and display the euro symbol.
return (i.ToString("c"));
}
}
Windows Form e le applicazioni console in esecuzione su tutte le versioni dei sistemi operativi Windows impostano il simbolo di valuta predefinito in base alle impostazioni nel computer dell'utente. Come è stato precisato in precedenza, questa impostazione potrebbe non essere corretta. Per fare in modo che vengano utilizzare le impostazioni predefinite di .NET Framework, l'applicazione deve creare un oggetto CultureInfo passando un parametro useUserOverride impostato su false.
Nell'esempio seguente viene utilizzato codice simile all'esempio precedente. Le impostazioni cultura correnti corrispondono a "fr-FR" e sulla console viene visualizzato un intero formattato come valuta. Le impostazioni sulla valuta locale dell'utente vengono utilizzate per formattare la valuta. Successivamente, le impostazioni cultura vengono impostate su "fr-FR" utilizzando il costruttore CultureInfo che accetta il parametro useUserOverride impostato su false. Il numero viene quindi formattato utilizzando le impostazioni predefinite di .NET Framework e viene visualizzato il simbolo di valuta dell'euro.
Imports System
Imports System.Globalization
Imports System.Threading
Public Class EuroSymbolSample
Public Shared Sub Main()
Dim i As Integer = 100
' Sets the CurrentCulture to French in France.
Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-FR")
' Displays i formatted as currency for the CurrentCulture.
' On a version of Windows prior to Windows XP, where the user
' has not changed the default currency to euro through the
' Control Panel, this will default to "F".
Console.WriteLine(i.ToString("c"))
' Sets the CurrentCulture to French in France, using the
' CultureInfo constructor that takes a useUserOverride parameter.
' Sets the useUserOverride value to false.
Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-FR", _
False)
' Displays i formatted as default currency for the CurrentCulture.
' On a version of Windows prior to Windows XP, this will override an
' incorrect default setting of "F" and display the euro symbol ().
Console.WriteLine(i.ToString("c"))
End Sub
End Class
using System;
using System.Globalization;
using System.Threading;
public class EuroSymbolSample
{
public static void Main()
{
int i = 100;
// Sets the CurrentCulture to French in France.
Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");
// Displays i formatted as default currency for the CurrentCulture.
// On a version of Windows prior to Windows XP, where the user
// has not changed the default currency to euro through the
// Control Panel, this will default to "F".
Console.WriteLine(i.ToString("c"));
// Sets the CurrentCulture to French in France, using the
// CultureInfo constructor that takes a useUserOverride parameter.
// Sets the useUserOverride value to false.
Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR",
false);
// Displays i formatted as default currency for the CurrentCulture.
// On a version of Windows prior to Windows XP, this will override an
// incorrect default setting of "F" and display the euro symbol ().
Console.WriteLine(i.ToString("c"));
}
}
Si noti che l'ambiente console non supporta il carattere dell'euro. Se si esegue questo codice in un'applicazione Windows Form, l'output avrà il seguente aspetto:
100,00 F
100,00 €
In molti paesi europei verranno utilizzate contemporaneamente due valute: l'euro e la valuta locale. È possibile che si verifichino casi in cui è necessario visualizzare entrambe le valute in un'applicazione. Nell'esempio di codice riportato di seguito viene creato un oggetto CultureInfo per le impostazioni cultura "fr-FR" in cui la valuta predefinita è l'euro. Per visualizzare il simbolo di valuta corrispondente alla valuta locale, utilizzare il metodo NumberFormatInfo.Clone per clonare un nuovo oggetto NumberFormatInfo per CultureInfo e sostituire il simbolo di valuta predefinito con il simbolo della valuta locale.
Imports System
Imports System.Globalization
Imports System.Threading
Public Class EuroLocalSample
Public Shared Sub Main()
' Creates a CultureInfo for French in France.
Dim FrCulture As New CultureInfo("fr-FR")
' Sets the CurrentCulture to fr-FR.
Thread.CurrentThread.CurrentCulture = FrCulture
' Clones the NumberFormatInfo and creates
' a new object for the local currency of France.
Dim LocalFormat As NumberFormatInfo =_
CType(NumberFormatInfo.CurrentInfo.Clone(), NumberFormatInfo)
' Replaces the default currency symbol
' with the local currency symbol.
LocalFormat.CurrencySymbol = "F"
Dim i As Integer = 100
' Displays i formatted as the local currency.
Console.WriteLine(i.ToString("c", LocalFormat))
' Displays i formatted as the default currency.
Console.WriteLine(i.ToString("c", NumberFormatInfo.CurrentInfo))
End Sub
End Class
using System;
using System.Globalization;
using System.Threading;
public class EuroLocalSample
{
public static void Main()
{
// Creates a CultureInfo for French in France.
CultureInfo FrCulture = new CultureInfo("fr-FR");
// Sets the CurrentCulture to fr-FR.
Thread.CurrentThread.CurrentCulture = FrCulture;
// Clones the NumberFormatInfo and creates
// a new object for the local currency of France.
NumberFormatInfo LocalFormat =
(NumberFormatInfo)NumberFormatInfo.CurrentInfo.Clone();
// Replaces the default currency symbol with the
// local currency symbol.
LocalFormat.CurrencySymbol = "F";
int i = 100;
// Displays i formatted as the local currency.
Console.WriteLine(i.ToString("c", LocalFormat));
// Displays i formatted as the default currency.
Console.WriteLine(i.ToString("c", NumberFormatInfo.CurrentInfo));
}
}
Per un esempio correlato, vedere l'esempio MultiCurrency in Guide rapide sulle attività comuni.