CultureInfo.DefaultThreadCurrentUICulture プロパティ

リファレンス

定義

名前空間:: System.Globalization

アセンブリ:: System.Globalization.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: CultureInfo.cs

ソース:: CultureInfo.cs

ソース:: CultureInfo.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在のアプリケーションドメイン内のスレッドの既定 UI カルチャを取得または設定します。

public:
 static property System::Globalization::CultureInfo ^ DefaultThreadCurrentUICulture { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };

public static System.Globalization.CultureInfo DefaultThreadCurrentUICulture { get; set; }

public static System.Globalization.CultureInfo? DefaultThreadCurrentUICulture { get; set; }

static member DefaultThreadCurrentUICulture : System.Globalization.CultureInfo with get, set

Public Shared Property DefaultThreadCurrentUICulture As CultureInfo

プロパティ値

CultureInfo

現在のアプリケーションドメイン内のスレッドの既定 UI カルチャ、または現在のシステム UI カルチャがアプリケーションドメイン内の既定スレッド UI カルチャである場合は null。

例外

ArgumentException

設定操作で、Name プロパティ値が正しくありません。

例

次の例は、新しいスレッドの現在のカルチャを定義する際の.NET Frameworkの既定の動作を示しています。英語とロシア語のリソースを使用します。 GreetingStrings.txt という名前の次のテキストファイルには、英語リソースが含まれています。

greeting =Hello again!
newGreeting=Hello!

これは、次のコマンドで Resource File Generator を使用して GreetingStrings.resources という名前のバイナリ .resources ファイルにコンパイルされます。

resgen greetingstrings.txt

GreetingStrings.ru-RU.txt という名前の次のテキストファイルには、ロシア語のリソースが含まれています。

greeting=Еще раз привет!
newGreeting=Привет!

これは、次のコマンドで Resource File Generator を使用して GreetingStrings.ru-RU.resources という名前のバイナリ .resources ファイルにコンパイルされます。

resgen greetingstrings.ru-RU.txt

次に示すアプリケーションコードは、Example1.vb または Example1.cs という名前のファイルに存在します。これは、Visual Basic コンパイラに対して次のコマンドを使用して実行可能ファイルにコンパイルされます。

vbc Example1.vb /resource:GreetingStrings.resources

C# コンパイラの場合、コマンドは次のようになります。

csc /resource:GreetingStrings.resources Example1.cs

これにより、例の実行可能コードとそのフォールバックカルチャのリソースを含むアセンブリが作成されます。アセンブリリンカーを使用して、次のコマンドを使用してロシア語 (ロシア) カルチャのリソースファイルを作成することもできます。

>al /embed:greetingstrings.ru-RU.resources /c:ru-RU /template:example1.exe /out:ru-RU\Example1.resources.dll

起動時に、既定のシステムカルチャが既にロシア語 (ロシア) であるシステムを除くすべてのシステムで、現在のカルチャと現在の UI カルチャをロシア語 (ロシア) に設定します。既定のシステムカルチャが既にロシア語 (ロシア) の場合、コードは現在のカルチャと現在の UI カルチャを英語 (米国) に設定します。次に、ルーチンを ShowGreeting 呼び出します。これにより、最初に呼び出されるときに単純な文字列が表示され、後続のメソッド呼び出しでは少し異なる文字列が表示されます。次に、ルーチンも実行する新しいスレッドを作成します ShowGreeting 。

using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;

[assembly:NeutralResourcesLanguageAttribute("en-US")]

public class Example
{
   private static int nGreetings = 0;
   private static ResourceManager rm;

   public static void Main()
   {
      AppDomain domain = AppDomain.CurrentDomain;
      rm = new ResourceManager("GreetingStrings",
                               typeof(Example).Assembly);

      CultureInfo culture = null;
      if (Thread.CurrentThread.CurrentUICulture.Name == "ru-RU")
         culture = CultureInfo.CreateSpecificCulture("en-US");
      else
         culture = CultureInfo.CreateSpecificCulture("ru-RU");

      Thread.CurrentThread.CurrentCulture = culture;
      Thread.CurrentThread.CurrentUICulture = culture;

      ShowGreeting();
      Thread.Sleep(1000);

      Thread workerThread = new Thread(Example.ShowGreeting);
      workerThread.Start();
   }

   private static void ShowGreeting()
   {
      string greeting = nGreetings == 0 ? rm.GetString("newGreeting") :
                                          rm.GetString("greeting");
      nGreetings++;
      Console.WriteLine("{0}", greeting);
   }
}
// The example displays the following output:
//       Привет!
//       Hello again!

Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading

<Assembly:NeutralResourcesLanguageAttribute("en-US")>

Public Class Example
   Private Shared nGreetings As Integer = 0
   Private Shared rm As ResourceManager

   Public Shared Sub Main()
      Dim domain As AppDomain = AppDomain.CurrentDomain
      rm = New ResourceManager("GreetingStrings", 
                               GetType(Example).Assembly)
                  
      Dim culture As CultureInfo = Nothing
      If Thread.CurrentThread.CurrentUICulture.Name = "ru-RU" Then
         culture = CultureInfo.CreateSpecificCulture("en-US")
      Else
         culture = CultureInfo.CreateSpecificCulture("ru-RU")
      End If   
      Thread.CurrentThread.CurrentCulture = culture
      Thread.CurrentThread.CurrentUICulture = culture

      ShowGreeting()
      Thread.Sleep(1000)

      Dim workerThread As New Thread(AddressOf Example.ShowGreeting)
      workerThread.Start()
   End Sub
   
   Private Shared Sub ShowGreeting()
      Dim greeting As String = CStr(IIf(nGreetings = 0, 
                                        rm.GetString("newGreeting"),
                                        rm.GetString("greeting")))
      nGreetings += 1
      Console.WriteLine("{0}", greeting)   
   End Sub
End Class
' The example displays the following output:
'       Привет!
'       Hello again!

この例の出力に示すように、システムカルチャが英語 (米国) のコンピューターで例を実行すると、メインスレッドは最初の文字列をロシア語で表示します。ただし、ワーカースレッドのカルチャは、アプリケーションの現在のカルチャではなく、現在の Windows システムカルチャから派生しているため、ワーカースレッドは文字列を英語で表示します。

次の例では、 DefaultThreadCurrentCulture プロパティと DefaultThreadCurrentUICulture プロパティを使用して、新しいアプリケーションスレッドの現在のカルチャと現在の UI カルチャを定義します。

この例では、前の例と同じリソースファイルを使用します。ローカライズされたロシア語リソースをサテライトアセンブリにコンパイルして埋め込むコマンドも同じですが、実行可能アセンブリの名前が変更される点が除きます。

起動時に、既定のシステムカルチャが既にロシア語 (ロシア) であるシステムを除くすべてのシステムで、現在のカルチャと現在の UI カルチャをロシア語 (ロシア) に設定します。既定のシステムカルチャが既にロシア語 (ロシア) の場合は、現在のカルチャと現在の UI カルチャを英語 (米国) に設定します。次に、ルーチンを ShowGreeting 呼び出します。これにより、最初に呼び出されるときに単純な文字列が表示され、後続のメソッド呼び出しでは少し異なる文字列が表示されます。次に、ルーチンも実行する新しいスレッドを作成します ShowGreeting 。

using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;

[assembly:NeutralResourcesLanguageAttribute("en-US")]

public class Example
{
   private static int nGreetings = 0;
   private static ResourceManager rm;

   public static void Main()
   {
      AppDomain domain = AppDomain.CurrentDomain;
      rm = new ResourceManager("GreetingStrings",
                               typeof(Example).Assembly);

      CultureInfo culture = null;
      if (Thread.CurrentThread.CurrentUICulture.Name == "ru-RU")
         culture = CultureInfo.CreateSpecificCulture("en-US");
      else
         culture = CultureInfo.CreateSpecificCulture("ru-RU");

      CultureInfo.DefaultThreadCurrentCulture = culture;
      CultureInfo.DefaultThreadCurrentUICulture = culture;

      Thread.CurrentThread.CurrentCulture = culture;
      Thread.CurrentThread.CurrentUICulture = culture;

      ShowGreeting();
      Thread.Sleep(1000);

      Thread workerThread = new Thread(Example.ShowGreeting);
      workerThread.Start();
   }

   private static void ShowGreeting()
   {
      string greeting = nGreetings == 0 ? rm.GetString("newGreeting") :
                                          rm.GetString("greeting");
      nGreetings++;
      Console.WriteLine("{0}", greeting);
   }
}
// The example displays the following output:
//       Привет!
//       Еще раз привет!

Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading

<Assembly:NeutralResourcesLanguageAttribute("en-US")>

Public Class Example
   Private Shared nGreetings As Integer = 0
   Private Shared rm As ResourceManager

   Public Shared Sub Main()
      Dim domain As AppDomain = AppDomain.CurrentDomain
      rm = New ResourceManager("GreetingStrings", 
                               GetType(Example).Assembly)
                  
      Dim culture As CultureInfo = Nothing
      If Thread.CurrentThread.CurrentUICulture.Name = "ru-RU" Then
         culture = CultureInfo.CreateSpecificCulture("en-US")
      Else
         culture = CultureInfo.CreateSpecificCulture("ru-RU")
      End If   
      CultureInfo.DefaultThreadCurrentCulture = culture
      CultureInfo.DefaultThreadCurrentUICulture = culture
       
      Thread.CurrentThread.CurrentCulture = culture
      Thread.CurrentThread.CurrentUICulture = culture

      ShowGreeting()
      Thread.Sleep(1000)

      Dim workerThread As New Thread(AddressOf Example.ShowGreeting)
      workerThread.Start()
   End Sub
   
   Private Shared Sub ShowGreeting()
      Dim greeting As String = CStr(IIf(nGreetings = 0, 
                                        rm.GetString("newGreeting"),
                                        rm.GetString("greeting")))
      nGreetings += 1
      Console.WriteLine("{0}", greeting)   
   End Sub
End Class
' The example displays the following output:
'       Привет!
'       Еще раз привет!

この例の出力に示すように、システムカルチャが英語 (米国) のコンピューターで例を実行すると、メインスレッドとワーカースレッドの両方に、ロシア語で文字列が表示されます。

注釈

.NET Framework 4 以前のバージョンでは、既定では、すべてのスレッドの UI カルチャが Windows システムカルチャに設定されています。現在の UI カルチャが既定のシステムカルチャと異なるアプリケーションの場合、多くの場合、この動作は望ましくありません。 .NET Framework 4.5 では、プロパティをDefaultThreadCurrentUICulture使用して、アプリケーションドメイン内のすべてのスレッドの既定の UI カルチャを定義できます。

重要

アプリケーションドメインで実行されている既存のスレッドの UI カルチャを明示的に設定していない場合は、プロパティを DefaultThreadCurrentUICulture 設定すると、これらのスレッドのカルチャも変更されます。ただし、これらのスレッドが別のアプリケーションドメインで実行される場合、そのカルチャは、そのアプリケーションドメインのプロパティによって DefaultThreadCurrentUICulture 定義されます。既定値が定義されていない場合は、既定のシステムカルチャによって定義されます。このため、メインアプリケーションスレッドのカルチャを常に明示的に設定し、プロパティをDefaultThreadCurrentUICulture使用してメインアプリケーションスレッドのカルチャを定義しないことをお勧めします。

明示的に設定されていない限り、プロパティの DefaultThreadCurrentUICulture 値はであり null、明示的なカルチャが割り当てられていないアプリケーションドメイン内のすべてのスレッドの現在のカルチャは、既定の Windows システムカルチャによって定義されます。

カルチャ、スレッド、およびアプリケーションドメインの詳細については、リファレンスページの「カルチャとスレッド」および「カルチャとアプリケーションドメイン」セクションを CultureInfo 参照してください。

適用対象

次の方法で共有

CultureInfo.DefaultThreadCurrentUICulture プロパティ

定義

プロパティ値

例外

例

注釈

適用対象

こちらもご覧ください

その他のリソース