System.Globalization.CultureInfo.CurrentCulture プロパティ

[アーティクル]
01/31/2024

この記事では、この API のリファレンスドキュメントへの補足的な解説を提供します。

プロパティとそれに関連付けられているオブジェクトによってCurrentCulture返されるオブジェクトによってCultureInfo、日付、時刻、数値、通貨値の既定の形式、テキストの並べ替え順序、大文字と小文字の表記規則、および文字列比較が決まります。

現在のカルチャは、実行中のスレッドのプロパティです。このプロパティを新しいカルチャを CultureInfo 表すオブジェクトに設定すると、プロパティの Thread.CurrentThread.CurrentCulture 値も変更されます。ただし、プロパティを常に使用して、現在の CultureInfo.CurrentCulture カルチャを取得して設定することをお勧めします。

このプロパティが返すオブジェクトは CultureInfo 読み取り専用です。つまり、既存のオブジェクトを変更することはできません。たとえば、DateTimeFormat 現在のカルチャの日時形式またはその他の側面を変更するには、新しい CultureInfo オブジェクトを作成してプロパティに割り当てます。

スレッドのカルチャの決定方法

スレッドが開始されると、そのカルチャは最初に次のように決定されます。

アプリケーションのプロパティで指定されたカルチャをDefaultThreadCurrentCulture取得することでメインスレッドが実行されている場合は、プロパティ値が実行されませんnull。

スレッドがタスクベースの非同期操作を実行しているスレッドプールスレッドの場合、そのカルチャは呼び出し元スレッドのカルチャによって決定されます。次の例では、現在のカルチャをポルトガル語 (ブラジル) に変更し、それぞれスレッド ID、タスク ID、および現在のカルチャを表示する 6 つのタスクを起動します。各タスク (およびスレッド) は、呼び出し元スレッドのカルチャを継承しています。

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

public class Example14
{
    public static async Task Main()
    {
        var tasks = new List<Task>();
        Console.WriteLine("The current culture is {0}",
                          Thread.CurrentThread.CurrentCulture.Name);
        Thread.CurrentThread.CurrentCulture = new CultureInfo("pt-BR");
        // Change the current culture to Portuguese (Brazil).
        Console.WriteLine("Current culture changed to {0}",
                          Thread.CurrentThread.CurrentCulture.Name);
        Console.WriteLine("Application thread is thread {0}",
                          Thread.CurrentThread.ManagedThreadId);
        // Launch six tasks and display their current culture.
        for (int ctr = 0; ctr <= 5; ctr++)
            tasks.Add(Task.Run(() =>
            {
                Console.WriteLine("Culture of task {0} on thread {1} is {2}",
                                  Task.CurrentId,
                                  Thread.CurrentThread.ManagedThreadId,
                                  Thread.CurrentThread.CurrentCulture.Name);
            }));

        await Task.WhenAll(tasks.ToArray());
    }
}
// The example displays output like the following:
//     The current culture is en-US
//     Current culture changed to pt-BR
//     Application thread is thread 9
//     Culture of task 2 on thread 11 is pt-BR
//     Culture of task 1 on thread 10 is pt-BR
//     Culture of task 3 on thread 11 is pt-BR
//     Culture of task 5 on thread 11 is pt-BR
//     Culture of task 6 on thread 11 is pt-BR
//     Culture of task 4 on thread 10 is pt-BR

Imports System.Globalization
Imports System.Threading

Module Example1
    Public Sub S1()
        Dim tasks As New List(Of Task)
        Console.WriteLine("The current culture is {0}",
                        Thread.CurrentThread.CurrentCulture.Name)
        Thread.CurrentThread.CurrentCulture = New CultureInfo("pt-BR")
        ' Change the current culture to Portuguese (Brazil).
        Console.WriteLine("Current culture changed to {0}",
                        Thread.CurrentThread.CurrentCulture.Name)
        Console.WriteLine("Application thread is thread {0}",
                        Thread.CurrentThread.ManagedThreadId)
        ' Launch six tasks and display their current culture.
        For ctr As Integer = 0 To 5
            tasks.Add(Task.Run(Sub()
                                   Console.WriteLine("Culture of task {0} on thread {1} is {2}",
                                                 Task.CurrentId,
                                                 Thread.CurrentThread.ManagedThreadId,
                                                 Thread.CurrentThread.CurrentCulture.Name)
                               End Sub))
        Next
        Task.WaitAll(tasks.ToArray())
    End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     Current culture changed to pt-BR
'     Application thread is thread 9
'     Culture of task 2 on thread 11 is pt-BR
'     Culture of task 1 on thread 10 is pt-BR
'     Culture of task 3 on thread 11 is pt-BR
'     Culture of task 5 on thread 11 is pt-BR
'     Culture of task 6 on thread 11 is pt-BR
'     Culture of task 4 on thread 10 is pt-BR

詳細については、「カルチャとタスクベースの非同期操作」を参照してください。

Windows 上で関数をGetUserDefaultLocaleName呼び出すかuloc_getDefault、現在カテゴリを持つ LC_MESSAGESPOSIX setlocale 関数を Unix に似たシステムで呼び出す ICU から関数を呼び出します。

システムにインストールされているカルチャまたはユーザーの優先カルチャとは異なる特定のカルチャを設定し、アプリケーションが複数のスレッドを開始する場合、スレッドが実行されているアプリケーションのプロパティにカルチャを割り当てない限り、それらのスレッドの現在のカルチャは関数によってGetUserDefaultLocaleName返されるカルチャDefaultThreadCurrentCultureになりますメイン注意してください。

スレッドのカルチャの決定方法の詳細については、参照ページの「カルチャとスレッド」セクションを CultureInfo 参照してください。

現在のカルチャを取得する

この CultureInfo.CurrentCulture プロパティはスレッドごとの設定です。つまり、各スレッドは独自のカルチャを持つことができます。次の例に示すように、プロパティの値を取得することで、現在のスレッドの CultureInfo.CurrentCulture カルチャを取得します。

using System;
using System.Globalization;

public class Example5
{
   public static void Main()
   {
      CultureInfo culture = CultureInfo.CurrentCulture;
      Console.WriteLine("The current culture is {0} [{1}]",
                        culture.NativeName, culture.Name);
   }
}
// The example displays output like the following:
//       The current culture is English (United States) [en-US]

Imports System.Globalization

Module Example3
    Public Sub S1()
        Dim culture As CultureInfo = CultureInfo.CurrentCulture
        Console.WriteLine("The current culture is {0} [{1}]",
                        culture.NativeName, culture.Name)
    End Sub
End Module
' The example displays output like the following:
'     The current culture is English (United States) [en-US]

CurrentCulture プロパティを明示的に設定する

既存のスレッドによって使用されるカルチャを変更するには、プロパティを CultureInfo.CurrentCulture 新しいカルチャに設定します。この方法でスレッドのカルチャを明示的に変更すると、スレッドがアプリケーションの境界を越えた場合メインその変更は保持されます。次の例では、現在のスレッドカルチャをオランダ語 (オランダ) に変更します。また、現在のスレッドがアプリケーションの境界を越えるとメイン現在のカルチャが変更メインことも示します。

using System;
using System.Globalization;
using System.Threading;

public class Info11 : MarshalByRefObject
{
    public void ShowCurrentCulture()
    {
        Console.WriteLine("Culture of {0} in application domain {1}: {2}",
                          Thread.CurrentThread.Name,
                          AppDomain.CurrentDomain.FriendlyName,
                          CultureInfo.CurrentCulture.Name);
    }
}

public class Example11
{
    public static void Main()
    {
        Info11 inf = new Info11();
        // Set the current culture to Dutch (Netherlands).
        Thread.CurrentThread.Name = "MainThread";
        CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture("nl-NL");
        inf.ShowCurrentCulture();

        // Create a new application domain.
        AppDomain ad = AppDomain.CreateDomain("Domain2");
        Info11 inf2 = (Info11)ad.CreateInstanceAndUnwrap(typeof(Info11).Assembly.FullName, "Info11");
        inf2.ShowCurrentCulture();
    }
}
// The example displays the following output:
//       Culture of MainThread in application domain ChangeCulture1.exe: nl-NL
//       Culture of MainThread in application domain Domain2: nl-NL

Imports System.Globalization
Imports System.Threading

Public Class Info : Inherits MarshalByRefObject
   Public Sub ShowCurrentCulture()
      Console.WriteLine("Culture of {0} in application domain {1}: {2}",
                        Thread.CurrentThread.Name,
                        AppDomain.CurrentDomain.FriendlyName,
                        CultureInfo.CurrentCulture.Name)
   End Sub
End Class

Module Example2
    Public Sub S1()
        Dim inf As New Info()
        ' Set the current culture to Dutch (Netherlands).
        Thread.CurrentThread.Name = "MainThread"
        CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture("nl-NL")
        inf.ShowCurrentCulture()

        ' Create a new application domain.
        Dim ad As AppDomain = AppDomain.CreateDomain("Domain2")
        Dim inf2 As Info = CType(ad.CreateInstanceAndUnwrap(GetType(Info).Assembly.FullName, "Info"),
                          Info)
        inf2.ShowCurrentCulture()
    End Sub
End Module
' This example displays the following output:
'       Culture of MainThread in application domain Example.exe: nl-NL
'       Culture of MainThread in application domain Domain2: nl-NL

Note

プロパティを使用してカルチャを CultureInfo.CurrentCulture 変更するには、 SecurityPermission 値が設定されたアクセス許可が ControlThread 必要です。スレッドの操作は、スレッドに関連付けられているセキュリティ状態のために危険です。そのため、このアクセス許可は信頼できるコードにのみ付与し、必要に応じてのみ付与する必要があります。半信頼コードでスレッドカルチャを変更することはできません。

.NET Framework 4 以降では、現在のスレッドカルチャを、特定のカルチャ (フランス語 (カナダ) など) またはニュートラルカルチャ (フランス語など) に明示的に変更できます。オブジェクトがCultureInfoニュートラルカルチャを表す場合、プロパティのCultureInfo Calendar値 (, CompareInfo, , DateTimeFormat NumberFormatなど) は、ニュートラルカルチャにTextInfo関連付けられている特定のカルチャを反映します。たとえば、英語の中立文化の主要なカルチャは英語 (米国) です。ドイツ文化の主な文化はドイツ語 (ドイツ) です。次の例は、現在のカルチャが特定のカルチャ、フランス語 (カナダ)、ニュートラルカルチャであるフランス語に設定されている場合の書式設定の違いを示しています。

using System;
using System.Globalization;
using System.Threading;

public class Example12
{
   public static void Main()
   {
      double value = 1634.92;
      CultureInfo.CurrentCulture = new CultureInfo("fr-CA");
      Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name);
      Console.WriteLine("{0:C2}\n", value);

      Thread.CurrentThread.CurrentCulture = new CultureInfo("fr");
      Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name);
      Console.WriteLine("{0:C2}", value);
   }
}
// The example displays the following output:
//       Current Culture: fr-CA
//       1 634,92 $
//
//       Current Culture: fr
//       1 634,92 €

Imports System.Globalization
Imports System.Threading

Module Example4
    Public Sub S1()
        Dim value As Double = 1634.92
        CultureInfo.CurrentCulture = New CultureInfo("fr-CA")
        Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name)
        Console.WriteLine("{0:C2}", value)
        Console.WriteLine()

        Thread.CurrentThread.CurrentCulture = New CultureInfo("fr")
        Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name)
        Console.WriteLine("{0:C2}", value)
    End Sub
End Module
' The example displays the following output:
'       Current Culture: fr-CA
'       1 634,92 $
'       
'       Current Culture: fr
'       1 634,92 €

次の CultureInfo.CurrentCulture 例に示すように、プロパティと共 HttpRequest.UserLanguages にプロパティを使用して、ASP.NET アプリケーションのプロパティをユーザーの優先カルチャに設定 CurrentCulture することもできます。

CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture(Request13.UserLanguages[0]);

Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(Request.UserLanguages(0))

現在のカルチャとユーザーのオーバーライド

Windows では、ユーザーは、コントロールパネルの地域と言語のオプションをCultureInfo使用して、オブジェクトとそれに関連付けられているオブジェクトの標準プロパティ値をオーバーライドできます。プロパティによって返されるオブジェクトは CultureInfo 、 CurrentCulture 次の場合にこれらのユーザーのオーバーライドを反映します。

現在のスレッドカルチャが Windows GetUserDefaultLocaleName 関数によって暗黙的に設定されている場合。
プロパティで定義されている現在のスレッドカルチャが DefaultThreadCurrentCulture 現在の Windows システムカルチャに対応する場合。
現在のスレッドカルチャがメソッドによって CreateSpecificCulture 返されるカルチャに明示的に設定され、そのカルチャが現在の Windows システムカルチャに対応する場合。
現在のスレッドカルチャがコンストラクターによって CultureInfo(String) インスタンス化されたカルチャに明示的に設定され、そのカルチャが現在の Windows システムカルチャに対応する場合。

場合によっては、特にサーバーアプリケーションの場合、ユーザーのオーバーライドを反映するオブジェクトに CultureInfo 現在のカルチャを設定することは望ましくない場合があります。代わりに、次の方法でユーザーのオーバーライドを CultureInfo 反映しないオブジェクトに現在のカルチャを設定できます。

引数の値falseをCultureInfo(String, Boolean)持つコンストラクターをuseUserOverride呼び出すこと。
キャッシュされた GetCultureInfo 読み取り専用 CultureInfo オブジェクトを返すメソッドを呼び出します。

現在のカルチャと UWP アプリ

ユニバーサル Windows プラットフォーム (UWP) アプリでは、CurrentCulture.NET Framework アプリと .NET Core アプリの場合と同様に、プロパティは読み取り/書き込み可能です。現在のカルチャの取得と設定の両方に使用できます。ただし、UWP アプリでは、現在のカルチャと現在の UI カルチャは区別されません。 CurrentCulture と CurrentUICulture プロパティは、Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages コレクションの最初の値にマップされます。

.NET Framework アプリと .NET Core アプリでは、現在のカルチャはスレッドごとの設定であり CurrentCulture 、プロパティには現在のスレッドのカルチャのみが反映されます。 UWP アプリでは、現在のカルチャは、グローバル設定である Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages プロパティにマップされます。プロパティを CurrentCulture 設定すると、アプリ全体のカルチャが変更されます。カルチャをスレッドごとに設定することはできません。