格式化特定文化特性的數值資料
更新：2007 年 11 月
NumberFormatInfo 類別定義如何根據文化特性來格式化和顯示貨幣、小數分隔符號和其他數值符號。例如，在英文 (美國) "en-US" 文化特性中，十進位數字 10000.50 會格式化為 10,000.50，在德文 (德國) "de-DE" 文化特性中，會格式化為 10.000,50。
NumberFormatInfo 物件可以為特定文化特性 (Culture) 或不因文化特性而異 (Invariant Culture) 建立，但不可為中性文化特性建立。中性文化特性並未提供足夠的資訊來顯示正確的數值格式。如果應用程式嘗試使用中性文化特性來建立 NumberFormatInfo 物件，將會擲回例外狀況。
下列程式碼範例會使用目前文化特性的 NumberFormatInfo 標準貨幣格式 ("c") 來顯示整數。
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));
}
}
這個程式碼產生下列輸出：
BZ$100.00
$100.00
kr100,00
格式化歐元國家貨幣
CultureInfo 和 RegionInfo 類別都包含貨幣的資訊。只有一個貨幣是根據文化特性來指定。歐元是下列國家的官方貨幣：比利時、德國、西班牙、法國、愛爾蘭、義大利、盧森堡、荷蘭、奧地利、葡萄牙、芬蘭和希臘。自 2002 年 1 月 1 日起，這些國家已開始使用歐元銀行紙幣和硬幣。因此，.NET Framework 和 Microsoft Windows XP 會為這十二個國家的預設貨幣符號設為歐元。舊版 Windows 仍會將預設貨幣符號設為這些國家的當地貨幣。
您必須注意作業系統的預設貨幣符號差異處。在 Windows 中，使用者可以透過 [控制台] 中的地區及語言選項，來覆寫作業系統預設文化特性的某些值。例如，使用者可以選擇使用符號 (而不是文化特性的預設值) 來顯示貨幣。Windows Form 和主控台應用程式 (Console Application) 使用作業系統所指定的預設貨幣符號。在舊版 Windows 中，如果歐元使用國家或地區的使用者並未將貨幣更新為歐元 (透過 [控制台] 的地區及語言選項)，其預設貨幣設定將會是錯誤的。ASP.NET 應用程式和 ASP.NET 中建立的 XML Web Service 應用程式將做為系統服務來執行，而不是針對特定使用者來執行。因此，它們傳回的預設結果將和 Windows Form 和主控台應用程式傳回的結果不同。
建議您替文化特性撰寫使用 .NET Framework 預設貨幣設定的程式碼，來保護您的應用程式不受作業系統的差異影響，並確保擁有一致的貨幣格式。您的應用程式應使用其中一個接受 useUserOverride 參數的建構函式多載，並將這個參數設為 false，來建立 CultureInfo 物件。這個設定將使得使用者作業系統的預設貨幣設定覆寫為 .NET Framework 的正確預設值。
在下列 XML Web Service 程式碼中，UserLocalSetting XML Web Service 方法將 CurrentCulture 屬性設為法文 (法國) "fr-FR"，並擷取格式化為貨幣的整數。由於作業系統的差異，您無法確定是否使用歐元符號或 "F" 符號。OverrideUserSetting XML Web 伺服器方法使用接受 useUserOverride 參數並將其設定為 false 的 CultureInfo 建構函式，將 CurrentCulture 屬性設為 "fr-FR"。這個方法會擷取貨幣格式的整數。在此情況下，由於歐元符號是 .NET Framework 的預設值，因此保證會使用歐元符號。
[Visual Basic]
<%@ 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 作業系統所有版本的 Windows Form 和主控台應用程式設定使用者電腦的設定值的預設貨幣符號。如前所述，該設定可能會有錯。若要確保使用 .NET Framework 的預設設定，您的應用程式必須建立 CultureInfo 物件，並傳遞設定為 false 的useUserOverride 參數。
下列範例使用的程式碼與前一個範例相似。該程式碼將目前的文化特性設為 "fr-FR" 並將格式化為貨幣的整數顯示給主控台。它將使用使用者的區域貨幣設定來格式化貨幣。接著，文化特性會使用接受 useUserOverride 參數並將其設為 false 的 CultureInfo 建構函式，來設定為 "fr-FR"。然後將使用 .NET Framework 預設設定來格式化這個數字，並顯示歐元貨幣符號。
[Visual Basic]
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"));
}
}
請注意，主控台環境不支援歐元字元。如果您在 Windows Form 應用程式中執行這個程式碼，它將產生下列輸出：
100,00 F
100,00 €
許多歐洲國家使用兩種通用的貨幣：歐元和區域貨幣。有時候使用者必須同時在應用程式顯示這兩種貨幣。下列程式碼範例為文化特性 "fr-FR" 建立 CultureInfo 物件，其預設貨幣為歐元。若要顯示本地貨幣的貨幣符號，您必須使用 NumberFormatInfo.Clone 方法為 CultureInfo 複製新的 NumberFormatInfo，然後使用本地貨幣符號來取代預設貨幣符號。
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));
}
}
如需相關範例，請參閱通用工作快速入門中的＜MultiCurrency 範例＞。