NumberFormatInfo クラス
カルチャに応じて、数値を形式指定および表示する方法を定義します。
この型のすべてのメンバの一覧については、NumberFormatInfo メンバ を参照してください。
System.Object
System.Globalization.NumberFormatInfo
<Serializable>
NotInheritable Public Class NumberFormatInfo Implements ICloneable, IFormatProvider
[C#]
[Serializable]
public sealed class NumberFormatInfo : ICloneable, IFormatProvider
[C++]
[Serializable]
public __gc __sealed class NumberFormatInfo : public ICloneable, IFormatProvider
[JScript]
public
Serializable
class NumberFormatInfo implements ICloneable, IFormatProvider
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
このクラスは、通貨、桁区切り記号、その他の数値記号などの情報を格納します。
特定のカルチャの NumberFormatInfo を作成するには、そのカルチャの CultureInfo を作成し、 CultureInfo.NumberFormat プロパティを取得します。現在のスレッドのカルチャに対して NumberFormatInfo を作成するには、 CurrentInfo プロパティを使用します。インバリアント カルチャの NumberFormatInfo を作成するには、読み取り専用バージョンでは InvariantInfo プロパティを使用し、書き込み可能バージョンでは NumberFormatInfo コンストラクタを使用します。ニュートラル カルチャの NumberFormatInfo は作成できません。
ユーザーは、[コントロール パネル] の [地域と言語のオプション] (オペレーティング システムによっては [地域のオプション] または [地域]) を使用して、Windows の現在のカルチャに関連付けられた値の一部をオーバーライドすることもできます。たとえば、ユーザーが別の形式で日付を表示したり、カルチャの既定の通貨以外の通貨を使用したりすることを選択する場合があります。 CultureInfo.UseUserOverride プロパティを true に設定した場合は、 CultureInfo.DateTimeFormat 、 CultureInfo.NumberFormat 、 CultureInfo.TextInfo の各インスタンスのプロパティもユーザー設定から取得されます。ユーザー設定が CultureInfo に関連付けられたカルチャと互換性を持たない場合 (たとえば、選択した暦が OptionalCalendars のいずれでもない場合)、メソッドの結果とプロパティの値は未定義になります。
数値は、 NumberFormatInfo のプロパティに格納されている標準パターンまたはカスタム パターンを使用して、形式指定します。値を表示する方法を変更するには、カスタム パターンをプロパティに保存するために、 NumberFormatInfo を書き込み可能にする必要があります。
各標準パターンの標準形式指定文字と、設定して標準パターンを変更できる関連付けられた NumberFormatInfo プロパティを次の表に示します。
| 書式指定文字 | 説明および関連付けられたプロパティ |
|---|---|
| c, C | 通貨書式。 CurrencyNegativePattern, CurrencyPositivePattern, CurrencySymbol, CurrencyGroupSizes, CurrencyGroupSeparator, CurrencyDecimalDigits, CurrencyDecimalSeparator. |
| d, D | Decimal 形式。 |
| e, E | Scientific (指数) 形式。 |
| f, F | Fixed-point 形式。 |
| g, G | General 形式。 |
| n, N | Number 形式。 NumberNegativePattern, NumberGroupSizes, NumberGroupSeparator, NumberDecimalDigits, NumberDecimalSeparator. |
| r, R | Roundtrip 形式。この形式では、文字列に変換された数値は、数値に再変換したときに同じ値になります。 |
| x, X | Hexadecimal 形式。 |
ニュートラル カルチャを除くインバリアント カルチャまたは特定のカルチャに対してだけ、 DateTimeFormatInfo または NumberFormatInfo を作成できます。インバリアント カルチャ、特定のカルチャ、およびニュートラル カルチャの詳細については、 CultureInfo クラスのトピックを参照してください。
このクラスは、 ICloneable インターフェイスを実装して、 NumberFormatInfo オブジェクトを複製できるようにします。アプリケーションに形式指定情報を提供するために、 IFormatProvider も実装します。
必要条件
名前空間: System.Globalization
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: Mscorlib (Mscorlib.dll 内)
参照
NumberFormatInfo メンバ | System.Globalization 名前空間 | Decimal | CultureInfo | 書式設定の概要