Thread.CurrentUICulture Свойство

Определение

Пространство имен:

System.Threading

Сборки:

netstandard.dll, System.Threading.Thread.dll

Исходный код:

Thread.cs

Возвращает или задает текущий язык и региональные параметры, используемые Resource Manager для поиска ресурсов, относящихся к языку и региональных параметров во время выполнения.

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

Значение свойства

CultureInfo

Объект, представляющий текущий язык и региональные параметры.

Исключения

ArgumentNullException

Для свойства задано значение null.

ArgumentException

Для свойства задано имя языка и региональных параметров, которое не может использоваться для поиска файла ресурса. Имена файлов ресурсов должны содержать только буквы, цифры, дефисы или символы подчеркивания.

InvalidOperationException

Только .NET Core и .NET 5+ — чтение или запись языка и региональных параметров потока из другого потока не поддерживается.

Примеры

В следующем примере определяется, является ли язык языка языка и региональных параметров пользовательского интерфейса текущего потока французским. Если это не так, он задает язык и региональные параметры пользовательского интерфейса текущего потока на английский (США).

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]

open System.Globalization
open System.Threading

// Change the current culture if the language is not French.
let current = Thread.CurrentThread.CurrentUICulture

if current.TwoLetterISOLanguageName <> "fr" then
    let newCulture = CultureInfo.CreateSpecificCulture "en-US"
    Thread.CurrentThread.CurrentUICulture <- newCulture
    // Make current UI culture consistent with current culture.
    Thread.CurrentThread.CurrentCulture <- newCulture

printfn
    $"The current UI culture is {Thread.CurrentThread.CurrentUICulture.NativeName} [{Thread.CurrentThread.CurrentUICulture.Name}]"

printfn
    $"The current culture is {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 Forms отображаться в языке и региональных параметрах, заданных на панели управления. Требуется дополнительный код.

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());
    }
}

open System.Threading
open System.Windows.Forms

type UICulture() =
    inherit Form()

    do
        // 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.

new UICulture() |> Application.Run

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

Комментарии

Язык и региональные параметры пользовательского интерфейса указывают ресурсы, необходимые приложению для поддержки ввода и вывода пользователей, и по умолчанию совпадает с языком и региональными параметрами операционной системы. CultureInfo Ознакомьтесь с классом, чтобы узнать о именах и идентификаторах языка и региональных параметров, различиях между инвариантными, нейтральными и конкретными языками и региональными параметрами, а также о том, как информация о языках и региональных параметрах влияет на потоки и домены приложений. Ознакомьтесь со свойством, чтобы узнать, как определяется язык и региональные CultureInfo.CurrentUICulture параметры пользовательского интерфейса потока по умолчанию.

Это важно

Свойство CurrentUICulture не работает надежно при использовании с любым потоком, кроме текущего потока. В .NET Framework чтение свойства является надежным, хотя установка его для потока, отличного от текущего потока, не является. В .NET Core создается исключение, InvalidOperationException если поток пытается считывать или записывать CurrentUICulture свойство в другом потоке. Мы рекомендуем использовать CultureInfo.CurrentUICulture свойство для получения и задания текущего языка и региональных параметров.

Возвращаемое этим свойством свойство может быть нейтральным языком и региональными CultureInfo параметрами. Нейтральные региональные параметры не должны использоваться с методами форматирования, такими как String.Format(IFormatProvider, String, Object[]), DateTime.ToString(String, IFormatProvider)и Convert.ToString(Char, IFormatProvider). CultureInfo.CreateSpecificCulture Используйте метод для получения определенного языка и региональных параметров или использования CurrentCulture свойства.