Thread.CurrentUICulture Thread.CurrentUICulture Thread.CurrentUICulture Thread.CurrentUICulture Property

定義

実行時にカルチャ固有のリソースを検索するためにリソース マネージャーで使用される、現在のカルチャを取得または設定します。Gets or sets the current culture used by the Resource Manager to look up culture-specific resources at run time.

public:
 property System::Globalization::CultureInfo ^ CurrentUICulture { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };
public System.Globalization.CultureInfo CurrentUICulture { get; set; }
member this.CurrentUICulture : System.Globalization.CultureInfo with get, set
Public Property CurrentUICulture As CultureInfo

プロパティ値

現在のカルチャを表すオブジェクト。An object that represents the current culture.

例外

プロパティが null に設定されています。The property is set to null.

プロパティが、リソース ファイルの検索に使用できないカルチャ名に設定されています。The property is set to a culture name that cannot be used to locate a resource file. リソース ファイル名に使用できるのは、文字、数字、ハイフン、またはアンダースコアのみです。Resource filenames must include only letters, numbers, hyphens or underscores.

.NET Core のみ: 別のスレッドからのスレッドのカルチャの読み取りまたは書き込みはサポートされていません。.NET Core only: Reading or writing the culture of a thread from another thread is not supported.

次の例では、現在のスレッドの UI カルチャの言語がフランス語であるかどうかを判断します。The following example determines whether the language of the current thread's UI culture is French. そうでない場合は、現在のスレッドの UI カルチャを英語 (米国) に設定します。If it is not, it sets the UI culture of the current thread to English (United States).

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

public class Example
{
   public static void Main()
   {
      // Change the current culture if the language is not French.
      CultureInfo current = Thread.CurrentThread.CurrentUICulture;
      if (current.TwoLetterISOLanguageName != "fr") {
         CultureInfo newCulture = CultureInfo.CreateSpecificCulture("en-US");
         Thread.CurrentThread.CurrentUICulture = newCulture;
         // Make current UI culture consistent with current culture.
         Thread.CurrentThread.CurrentCulture = newCulture;
      }
      Console.WriteLine("The current UI culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name);
      Console.WriteLine("The current culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name);
   }
}
// The example displays the following output:
//     The current UI culture is English (United States) [en-US]
//     The current culture is English (United States) [en-US]
Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      ' Change the current culture if the language is not French.
      Dim current As CultureInfo = Thread.CurrentThread.CurrentUICulture
      If current.TwoLetterISOLanguageName <> "fr" Then
         Dim newCulture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
         Thread.CurrentThread.CurrentUICulture = newCulture
         ' Make current UI culture consistent with current culture.
         Thread.CurrentThread.CurrentCulture = newCulture
      End If
      Console.WriteLine("The current UI culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name)
      Console.WriteLine("The current culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name)
   End Sub
End Module
' The example displays output like the following:
'     The current UI culture is English (United States) [en-US]
'     The current culture is English (United States) [en-US]

次のコード例は、Windows フォームのユーザーインターフェイスをコントロールパネルで設定されているカルチャで表示できるようにするスレッドステートメントを示しています。The following code example shows the threading statement that allows the user interface of a Windows Forms to display in the culture that is set in Control Panel. 追加のコードが必要です。Additional code is needed.

#using <system.dll>
#using <System.Drawing.dll>
#using <system.windows.forms.dll>

using namespace System;
using namespace System::Threading;
using namespace System::Windows::Forms;
ref class UICulture: public Form
{
public:
   UICulture()
   {
      
      // Set the user interface to display in the
      // same culture as that set in Control Panel.
      Thread::CurrentThread->CurrentUICulture = Thread::CurrentThread->CurrentCulture;
      
      // Add additional code.
   }
};


int main()
{
   Application::Run( gcnew UICulture );
}
using System;
using System.Threading;
using System.Windows.Forms;

class UICulture : Form
{
    public UICulture()
    {
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = 
            Thread.CurrentThread.CurrentCulture;

        // Add additional code.
    }

    static void Main()
    {
        Application.Run(new UICulture());
    }
}
Imports System.Threading
Imports System.Windows.Forms

Public Class UICulture : Inherits Form
    Sub New()

        ' Set the user interface to display in the
        ' same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = _
            Thread.CurrentThread.CurrentCulture

        ' Add additional code.
    End Sub

    Shared Sub Main()
        Application.Run(New UICulture())
    End Sub
End Class

注釈

UI カルチャは、ユーザーの入力と出力をサポートするためにアプリケーションが必要とするリソースを指定します。既定では、オペレーティングシステムのカルチャと同じです。The UI culture specifies the resources an application needs to support user input and output, and by default is the same as the operating system culture. CultureInfoクラスを参照して、カルチャの名前と識別子、インバリアント、ニュートラル、および特定のカルチャの違い、およびカルチャ情報がスレッドとアプリケーションドメインに与える影響について学習します。See the CultureInfo class to learn about culture names and identifiers, the differences between invariant, neutral, and specific cultures, and the way culture information affects threads and application domains. スレッドのCultureInfo.CurrentUICulture既定の UI カルチャがどのように決定されるかについては、プロパティを参照してください。See the CultureInfo.CurrentUICulture property to learn how a thread's default UI culture is determined.

重要

現在CurrentUICultureのスレッド以外のスレッドで使用する場合、プロパティは確実に動作しません。The CurrentUICulture property doesn't work reliably when used with any thread other than the current thread. .NET Framework では、プロパティの読み取りは信頼できますが、現在のスレッド以外のスレッドに対して設定することは可能です。In .NET Framework, reading the property is reliable, although setting it for a thread other than the current thread is not. .Net Core InvalidOperationExceptionでは、スレッドが別のスレッドでプロパティのCurrentUICulture読み取りまたは書き込みを行おうとすると、がスローされます。On .NET Core, an InvalidOperationException is thrown if a thread attempts to read or write the CurrentUICulture property on a different thread. 現在のカルチャを取得しCultureInfo.CurrentUICultureて設定するには、プロパティを使用することをお勧めします。We recommend that you use the CultureInfo.CurrentUICulture property to retrieve and set the current culture.

このCultureInfoプロパティによって返されるは、ニュートラルカルチャにすることができます。The CultureInfo returned by this property can be a neutral culture. ニュートラルカルチャはString.Format(IFormatProvider, String, Object[])、、 DateTime.ToString(String, IFormatProvider)Convert.ToString(Char, IFormatProvider)などの書式指定メソッドでは使用しないでください。Neutral cultures should not be used with formatting methods such as String.Format(IFormatProvider, String, Object[]), DateTime.ToString(String, IFormatProvider), and Convert.ToString(Char, IFormatProvider). メソッドをCultureInfo.CreateSpecificCulture使用して特定のカルチャを取得するかCurrentCulture 、プロパティを使用します。Use the CultureInfo.CreateSpecificCulture method to get a specific culture, or use the CurrentCulture property.

注意

このCultureInfo.CreateSpecificCultureメソッドはArgumentException 、ニュートラルカルチャ "zh-tw-zh-hant" ("zh-tw") と "zh-tw-Hans" ("zh-tw-CHS") に対してをスローします。The CultureInfo.CreateSpecificCulture method throws ArgumentException for the neutral cultures "zh-Hant" ("zh-CHT") and "zh-Hans" ("zh-CHS").

適用対象