方法: カスタムカルチャを作成する

[アーティクル]
08/09/2011

更新 : 2010 年 12 月

.NET Framework および Windows オペレーティングシステムに用意されている定義済みのカルチャは、特定の国や地域で使用される言語と予定表を指定するほか、文字列、日付、および数値を書式設定、解析、および比較する場合に使用されるテキスト規則を示します。一方、必要な情報が定義済みのカルチャで規定されていない場合は、カスタムカルチャを作成できます。

カスタムカルチャを定義および作成するには

CultureAndRegionInfoBuilder オブジェクトを使用して、カスタムカルチャを定義し、名前を付けます。カスタムカルチャは、まったく新しく作成することも、既存のカルチャに基づく新しいカルチャを作成することも、既存の .NET Framework カルチャまたは Windows ロケールを置き換えるカルチャとして作成することもできます。

新しいカルチャの場合は、CultureAndRegionInfoBuilder.LoadDataFromCultureInfo メソッドを呼び出して CultureAndRegionInfoBuilder オブジェクトのプロパティにカルチャ情報を設定し、CultureAndRegionInfoBuilder.LoadDataFromRegionInfo メソッドを呼び出して地域情報を設定することができます。カルチャを置き換える場合は、置換対象のカルチャのプロパティから、CultureAndRegionInfoBuilder オブジェクトのプロパティが自動的に作成されます。
必要に応じて、CultureAndRegionInfoBuilder オブジェクトのプロパティを変更します。

CultureAndRegionInfoBuilder.Register メソッドを呼び出して、カスタムカルチャを登録します。登録処理では以下のタスクが実行されます。

.nlp ファイル (CultureAndRegionInfoBuilder オブジェクトで定義された情報を格納する) を作成します。
使用しているコンピューターのシステムディレクトリ %windir%\Globalization に、 .nlp ファイルを格納します。これにより、カルチャ情報はコンピューターの電源をオフにしても保持されます。 .nlp ファイルがシステムディレクトリに格納されるため、開発者はこのコンピューターに対する管理者特権を持つ必要があります。
次回カスタムカルチャを新規作成する必要がある場合に備えて、内部キャッシュではなく %windir%\Globalization システムディレクトリを検索するように .NET Framework を設定しておきます。

注意
カスタムカルチャを登録するコンピューターに対する管理者特権がない場合は、CultureAndRegionInfoBuilder.Register メソッドの呼び出しによって UnauthorizedAccessException がスローされます。リフレクションを使用してプライベートメソッドを呼び出すことにより、この要件を回避できます。詳細については、「方法: 管理者特権なしでカスタムカルチャを保存する」を参照してください。

カスタムカルチャを登録するコンピューターに対する管理者特権がない場合は、CultureAndRegionInfoBuilder.Register メソッドの呼び出しによって UnauthorizedAccessException がスローされます。リフレクションを使用してプライベートメソッドを呼び出すことにより、この要件を回避できます。詳細については、「方法: 管理者特権なしでカスタムカルチャを保存する」を参照してください。

以上で、カスタムカルチャが、コンピューター上の定義済みの各 .NET Framework カルチャや Windows ロケールと同じステータスを持つようになりました。カスタムカルチャは、CultureAndRegionInfoBuilder.Unregister メソッドを呼び出して、 .nlp ファイルをローカルコンピューターから削除するまで使用できます。

カスタムカルチャに基づいて CultureInfo オブジェクトをインスタンス化するには、CultureInfo クラスコンストラクターにその名前を指定します。

使用例

次の例では、CultureAndRegionInfoBuilder クラスを使用して x-en-US-sample という名前のカスタムカルチャを定義および登録し、このカスタムカルチャ用の CultureInfo オブジェクトを構築しています。この例には、CultureAndRegionInfoBuilder オブジェクトおよび CultureInfo オブジェクトの対応するプロパティもいくつか示しています。

' This example demonstrates the System.Globalization.Culture-
' AndRegionInfoBuilder Register method.
' Compile this code example with a reference to sysglobl.dll.

Imports System
Imports System.Globalization

Class Sample
    Public Shared Sub Main() 
        Dim cib As CultureAndRegionInfoBuilder = Nothing
        Try
            ' Create a CultureAndRegionInfoBuilder object named "x-en-US-sample".
            Console.WriteLine("Create and explore the CultureAndRegionInfoBuilder..." & vbCrLf)
            cib = New CultureAndRegionInfoBuilder("x-en-US-sample", CultureAndRegionModifiers.None)

            ' Populate the new CultureAndRegionInfoBuilder object with culture information.
            Dim ci As New CultureInfo("en-US")
            cib.LoadDataFromCultureInfo(ci)

            ' Populate the new CultureAndRegionInfoBuilder object with region information.
            Dim ri As New RegionInfo("US")
            cib.LoadDataFromRegionInfo(ri)

            ' Display some of the properties of the CultureAndRegionInfoBuilder object.
            Console.WriteLine("CultureName:. . . . . . . . . . {0}", cib.CultureName)
            Console.WriteLine("CultureEnglishName: . . . . . . {0}", cib.CultureEnglishName)
            Console.WriteLine("CultureNativeName:. . . . . . . {0}", cib.CultureNativeName)
            Console.WriteLine("GeoId:. . . . . . . . . . . . . {0}", cib.GeoId)
            Console.WriteLine("IsMetric: . . . . . . . . . . . {0}", cib.IsMetric)
            Console.WriteLine("ISOCurrencySymbol:. . . . . . . {0}", cib.ISOCurrencySymbol)
            Console.WriteLine("RegionEnglishName:. . . . . . . {0}", cib.RegionEnglishName)
            Console.WriteLine("RegionName: . . . . . . . . . . {0}", cib.RegionName)
            Console.WriteLine("RegionNativeName: . . . . . . . {0}", cib.RegionNativeName)
            Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", cib.ThreeLetterISOLanguageName)
            Console.WriteLine("ThreeLetterISORegionName: . . . {0}", cib.ThreeLetterISORegionName)
            Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", cib.ThreeLetterWindowsLanguageName)
            Console.WriteLine("ThreeLetterWindowsRegionName: . {0}", cib.ThreeLetterWindowsRegionName)
            Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", cib.TwoLetterISOLanguageName)
            Console.WriteLine("TwoLetterISORegionName: . . . . {0}", cib.TwoLetterISORegionName)
            Console.WriteLine()

            ' Register the custom culture.
            Console.WriteLine("Register the custom culture...")
            cib.Register()

            ' Display some of the properties of the custom culture.
            Console.WriteLine("Create and explore the custom culture..." & vbCrLf)
            ci = New CultureInfo("x-en-US-sample")

            Console.WriteLine("Name: . . . . . . . . . . . . . {0}", ci.Name)
            Console.WriteLine("EnglishName:. . . . . . . . . . {0}", ci.EnglishName)
            Console.WriteLine("NativeName: . . . . . . . . . . {0}", ci.NativeName)
            Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", ci.TwoLetterISOLanguageName)
            Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", ci.ThreeLetterISOLanguageName)
            Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", ci.ThreeLetterWindowsLanguageName)

            Console.WriteLine(vbCrLf & "Note:" & vbCrLf & "Use the example in the " & _
                              "Unregister method topic to remove the custom culture.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

    End Sub 'Main
End Class 'Sample

'This code example produces the following results:
'
'Create and explore the CultureAndRegionInfoBuilder...
'
'CultureName:. . . . . . . . . . x-en-US-sample
'CultureEnglishName: . . . . . . English (United States)
'CultureNativeName:. . . . . . . English (United States)
'GeoId:. . . . . . . . . . . . . 244
'IsMetric: . . . . . . . . . . . False
'ISOCurrencySymbol:. . . . . . . USD
'RegionEnglishName:. . . . . . . United States
'RegionName: . . . . . . . . . . x-en-US-sample
'RegionNativeName: . . . . . . . United States
'ThreeLetterISOLanguageName: . . eng
'ThreeLetterISORegionName: . . . USA
'ThreeLetterWindowsLanguageName: ENU
'ThreeLetterWindowsRegionName: . USA
'TwoLetterISOLanguageName: . . . en
'TwoLetterISORegionName: . . . . US
'
'Register the custom culture...
'Create and explore the custom culture...
'
'Name: . . . . . . . . . . . . . x-en-US-sample
'EnglishName:. . . . . . . . . . English (United States)
'NativeName: . . . . . . . . . . English (United States)
'TwoLetterISOLanguageName: . . . en
'ThreeLetterISOLanguageName: . . eng
'ThreeLetterWindowsLanguageName: ENU
'
'Note:
'Use the example in the Unregister method topic to remove the custom culture.
'

// This example demonstrates the System.Globalization.Culture-
// AndRegionInfoBuilder Register method.
// Compile this code example with a reference to sysglobl.dll.

using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    CultureAndRegionInfoBuilder cib = null;
    try 
    {
// Create a CultureAndRegionInfoBuilder object named "x-en-US-sample".
    Console.WriteLine("Create and explore the CultureAndRegionInfoBuilder...\n");
    cib = new CultureAndRegionInfoBuilder(
                         "x-en-US-sample", CultureAndRegionModifiers.None);

// Populate the new CultureAndRegionInfoBuilder object with culture information.
    CultureInfo ci = new CultureInfo("en-US");
    cib.LoadDataFromCultureInfo(ci);

// Populate the new CultureAndRegionInfoBuilder object with region information.
    RegionInfo  ri = new RegionInfo("US");
    cib.LoadDataFromRegionInfo(ri);

// Display some of the properties of the CultureAndRegionInfoBuilder object.
    Console.WriteLine("CultureName:. . . . . . . . . . {0}", cib.CultureName);
    Console.WriteLine("CultureEnglishName: . . . . . . {0}", cib.CultureEnglishName);
    Console.WriteLine("CultureNativeName:. . . . . . . {0}", cib.CultureNativeName);
    Console.WriteLine("GeoId:. . . . . . . . . . . . . {0}", cib.GeoId);
    Console.WriteLine("IsMetric: . . . . . . . . . . . {0}", cib.IsMetric);
    Console.WriteLine("ISOCurrencySymbol:. . . . . . . {0}", cib.ISOCurrencySymbol);
    Console.WriteLine("RegionEnglishName:. . . . . . . {0}", cib.RegionEnglishName);
    Console.WriteLine("RegionName: . . . . . . . . . . {0}", cib.RegionName);
    Console.WriteLine("RegionNativeName: . . . . . . . {0}", cib.RegionNativeName);
    Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", cib.ThreeLetterISOLanguageName);
    Console.WriteLine("ThreeLetterISORegionName: . . . {0}", cib.ThreeLetterISORegionName);
    Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", cib.ThreeLetterWindowsLanguageName);
    Console.WriteLine("ThreeLetterWindowsRegionName: . {0}", cib.ThreeLetterWindowsRegionName);
    Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", cib.TwoLetterISOLanguageName);
    Console.WriteLine("TwoLetterISORegionName: . . . . {0}", cib.TwoLetterISORegionName);
    Console.WriteLine();

// Register the custom culture.
    Console.WriteLine("Register the custom culture...");
    cib.Register();

// Display some of the properties of the custom culture.
    Console.WriteLine("Create and explore the custom culture...\n");
    ci = new CultureInfo("x-en-US-sample");

    Console.WriteLine("Name: . . . . . . . . . . . . . {0}", ci.Name);
    Console.WriteLine("EnglishName:. . . . . . . . . . {0}", ci.EnglishName);
    Console.WriteLine("NativeName: . . . . . . . . . . {0}", ci.NativeName);
    Console.WriteLine("TwoLetterISOLanguageName: . . . {0}", ci.TwoLetterISOLanguageName);
    Console.WriteLine("ThreeLetterISOLanguageName: . . {0}", ci.ThreeLetterISOLanguageName);
    Console.WriteLine("ThreeLetterWindowsLanguageName: {0}", ci.ThreeLetterWindowsLanguageName);

    Console.WriteLine("\nNote:\n" +
        "Use the example in the Unregister method topic to remove the custom culture.");
    }
    catch (Exception e)
    {
        Console.WriteLine(e);
    }
    }
}
/*
This code example produces the following results:

Create and explore the CultureAndRegionInfoBuilder...

CultureName:. . . . . . . . . . x-en-US-sample
CultureEnglishName: . . . . . . English (United States)
CultureNativeName:. . . . . . . English (United States)
GeoId:. . . . . . . . . . . . . 244
IsMetric: . . . . . . . . . . . False
ISOCurrencySymbol:. . . . . . . USD
RegionEnglishName:. . . . . . . United States
RegionName: . . . . . . . . . . x-en-US-sample
RegionNativeName: . . . . . . . United States
ThreeLetterISOLanguageName: . . eng
ThreeLetterISORegionName: . . . USA
ThreeLetterWindowsLanguageName: ENU
ThreeLetterWindowsRegionName: . USA
TwoLetterISOLanguageName: . . . en
TwoLetterISORegionName: . . . . US

Register the custom culture...
Create and explore the custom culture...

Name: . . . . . . . . . . . . . x-en-US-sample
EnglishName:. . . . . . . . . . English (United States)
NativeName: . . . . . . . . . . English (United States)
TwoLetterISOLanguageName: . . . en
ThreeLetterISOLanguageName: . . eng
ThreeLetterWindowsLanguageName: ENU

Note:
Use the example in the Unregister method topic to remove the custom culture.

*/

参照

CultureInfo

CultureAndRegionInfoBuilder

CultureAndRegionModifiers

その他の技術情報

エンコーディングとローカリゼーション

履歴の変更

日付	履歴	理由
2010 年 12 月	管理者特権なしでのカスタムカルチャの保存に関する説明を追加。	情報の拡充

2010 年 12 月

管理者特権なしでのカスタムカルチャの保存に関する説明を追加。

情報の拡充

次の方法で共有

方法: カスタムカルチャを作成する

カスタムカルチャを定義および作成するには

使用例

参照

参照

その他の技術情報

履歴の変更

その他のリソース

次の方法で共有

方法: カスタム カルチャを作成する

カスタム カルチャを定義および作成するには

使用例

参照

参照

その他の技術情報

履歴の変更

その他のリソース

方法: カスタムカルチャを作成する

カスタムカルチャを定義および作成するには