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-hant"("ZH-CHT") と"Zh-hans"("ZH-CHS")。The CultureInfo.CreateSpecificCulture method throws ArgumentException for the neutral cultures "zh-Hant" ("zh-CHT") and "zh-Hans" ("zh-CHS").

適用対象