CultureInfo.CurrentUICulture Свойство

Определение

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

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

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

CultureInfo

Язык и региональные параметры, используемые диспетчером ресурсов для поиска ресурсов, связанных с языком и региональными параметрами, во время выполнения.

Исключения

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

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

Примеры

В следующем примере кода показано, как изменить CurrentCulture и для CurrentUICulture текущего потока.

using namespace System;
using namespace System::Globalization;
using namespace System::Threading;

int main()
{
   // Display the name of the current thread culture.
   Console::WriteLine("CurrentCulture is {0}.", CultureInfo::CurrentCulture->Name);
   
   // Change the current culture to th-TH.
   CultureInfo::CurrentCulture = gcnew CultureInfo("th-TH",false);
   Console::WriteLine("CurrentCulture is now {0}.", CultureInfo::CurrentCulture->Name);
   
   // Displays the name of the CurrentUICulture of the current thread.
   Console::WriteLine("CurrentUICulture is {0}.", CultureInfo::CurrentCulture->Name);
   
   // Changes the CurrentUICulture of the current thread to ja-JP.
   CultureInfo::CurrentUICulture = gcnew CultureInfo("ja-JP",false);
   Console::WriteLine("CurrentUICulture is now {0}.", CultureInfo::CurrentCulture->Name);
}
// The example displays the following output:
//       CurrentCulture is en-US.
//       CurrentCulture is now th-TH.
//       CurrentUICulture is en-US.
//       CurrentUICulture is now ja-JP.
using System;
using System.Globalization;
using System.Threading;

public class Example0
{
   public static void Main()
   {
      // Display the name of the current culture.
      Console.WriteLine("CurrentCulture is {0}.", CultureInfo.CurrentCulture.Name);

      // Change the current culture to th-TH.
      CultureInfo.CurrentCulture = new CultureInfo("th-TH", false);
      Console.WriteLine("CurrentCulture is now {0}.", CultureInfo.CurrentCulture.Name);

      // Display the name of the current UI culture.
      Console.WriteLine("CurrentUICulture is {0}.", CultureInfo.CurrentUICulture.Name);

      // Change the current UI culture to ja-JP.
      CultureInfo.CurrentUICulture = new CultureInfo( "ja-JP", false );
      Console.WriteLine("CurrentUICulture is now {0}.", CultureInfo.CurrentUICulture.Name);
   }
}
// The example displays the following output:
//       CurrentCulture is en-US.
//       CurrentCulture is now th-TH.
//       CurrentUICulture is en-US.
//       CurrentUICulture is now ja-JP.
Imports System.Globalization
Imports System.Threading

Public Module Example
   Public Sub Main()

      ' Display the name of the current culture.
      Console.WriteLine("CurrentCulture is {0}.", CultureInfo.CurrentCulture.Name)

      ' Change the current culture to th-TH.
      CultureInfo.CurrentCulture = New CultureInfo("th-TH", False)
      Console.WriteLine("CurrentCulture is now {0}.", CultureInfo.CurrentCulture.Name)

      ' Display the name of the current UI culture.
      Console.WriteLine("CurrentUICulture is {0}.", CultureInfo.CurrentUICulture.Name)

      ' Change the current UI culture to ja-JP.
      CultureInfo.CurrentUICulture = New CultureInfo("ja-JP", False)
      Console.WriteLine("CurrentUICulture is now {0}.", CultureInfo.CurrentUICulture.Name)
   End Sub 
End Module
' The example displays the following output:
'       CurrentCulture is en-US.
'       CurrentCulture is now th-TH.
'       CurrentUICulture is en-US.
'       CurrentUICulture is now ja-JP.

Комментарии

Текущий язык и региональные параметры пользовательского интерфейса — это свойство для каждого потока. То есть каждый поток имеет собственный текущий язык и региональные параметры пользовательского интерфейса. это свойство эквивалентно извлечению или, начиная с платформа .NET Framework 4,6, устанавливая объект, CultureInfo присвоенный System.Threading.Thread.CurrentThread.CurrentUICulture свойству. При запуске потока его культура пользовательского интерфейса изначально определяется следующим образом:

  • При извлечении языка и региональных параметров, заданных DefaultThreadCurrentUICulture свойством в домене приложения, в котором выполняется поток, если значение свойства не равно null .

  • если поток является потоком пула потоков, который выполняет асинхронную операцию на основе задач, а приложение предназначено для платформа .NET Framework 4,6 или более поздней версии платформа .NET Framework, его культура пользовательского интерфейса определяется культурой пользовательского интерфейса вызывающего потока. Следующий пример изменяет текущий язык и региональные параметры пользовательского интерфейса на португальский (Бразилия) и запускает шесть задач, каждый из которых отображает идентификатор своего потока, идентификатор задачи и текущий язык и региональные параметры пользовательского интерфейса. Каждая из задач (и потоков) унаследовала культуру пользовательского интерфейса вызывающего потока.

    using System;
    using System.Collections.Generic;
    using System.Globalization;
    using System.Runtime.Versioning;
    using System.Threading;
    using System.Threading.Tasks;
    
    [assembly:TargetFramework(".NETFramework,Version=v4.6")]
    
    public class Example
    {
       public static async Task Main()
       {
          var tasks = new List<Task>();
          Console.WriteLine("The current UI culture is {0}",
                            Thread.CurrentThread.CurrentUICulture.Name);
          Thread.CurrentThread.CurrentUICulture = new CultureInfo("pt-BR");
          // Change the current UI culture to Portuguese (Brazil).
          Console.WriteLine("Current UI culture changed to {0}",
                            Thread.CurrentThread.CurrentUICulture.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("UI Culture of task {0} on thread {1} is {2}",
                                                     Task.CurrentId,
                                                     Thread.CurrentThread.ManagedThreadId,
                                                     Thread.CurrentThread.CurrentUICulture.Name);
                                } ));
    
          await Task.WhenAll(tasks.ToArray());
       }
    }
    // The example displays output like the following:
    //     The current UI culture is en-US
    //     Current UI culture changed to pt-BR
    //     Application thread is thread 9
    //     UI Culture of task 2 on thread 11 is pt-BR
    //     UI Culture of task 1 on thread 10 is pt-BR
    //     UI Culture of task 3 on thread 11 is pt-BR
    //     UI Culture of task 5 on thread 11 is pt-BR
    //     UI Culture of task 6 on thread 11 is pt-BR
    //     UI Culture of task 4 on thread 10 is pt-BR
    
    Imports System.Collections.Generic
    Imports System.Globalization
    Imports System.Runtime.Versioning
    Imports System.Threading
    Imports System.Threading.Tasks
    
    <assembly:TargetFramework(".NETFramework,Version=v4.6")>
    
    Module Example
       Public Sub Main()
          Dim tasks As New List(Of Task)
          Console.WriteLine("The current UI culture is {0}", 
                            Thread.CurrentThread.CurrentUICulture.Name)
          Thread.CurrentThread.CurrentUICulture = New CultureInfo("pt-BR")
          ' Change the current UI culture to Portuguese (Brazil).
          Console.WriteLine("Current culture changed to {0}",
                            Thread.CurrentThread.CurrentUICulture.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.CurrentUICulture.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
    

    Дополнительные сведения см. в разделе "Культура и асинхронные операции на основе задач" CultureInfo статьи.

  • путем вызова функции Windows GetUserDefaultUILanguage .

Примечание

В .NET Compact Framework CurrentUICulture свойство доступно только для чтения. Текущий язык и региональные параметры пользовательского интерфейса определяются региональными параметрами системы и не могут быть изменены программным способом.

начиная с платформа .NET Framework 4,6, чтобы изменить язык и региональные параметры пользовательского интерфейса, используемые потоком, задайте Thread.CurrentUICulture для свойства новый язык и региональные параметры. Если вы явно изменяете язык и региональные параметры пользовательского интерфейса потока таким образом, это изменение сохраняется, если поток пересекает границы домена приложения.

Примечание

в платформа .NET Framework 4.5.2 и более ранних версиях CurrentUICulture свойство доступно только для чтения. Это значит, что вы можете получить значение свойства, но не можете его задать. Чтобы изменить текущий язык и региональные параметры пользовательского интерфейса, необходимо назначить CultureInfo свойству объект, представляющий новый язык и региональные параметры пользовательского интерфейса Thread.CurrentThread.CurrentUICulture . начиная с платформа .NET Framework 4,6, CultureInfo.CurrentUICulture свойство доступно для чтения и записи; можно задавать и извлекать значение свойства. Если задать значение свойства для CultureInfo объекта, представляющего новый язык и региональные параметры, значение Thread.CurrentThread.CurrentCulture свойства также изменится.

Содержание

Получение текущего языка и региональных параметров пользовательского интерфейса
Явное задание текущего языка и региональных параметров пользовательского интерфейса
Неявная установка текущего языка и региональных параметров пользовательского интерфейса
Вопросы безопасности
текущий язык и региональные параметры пользовательского интерфейса и приложения Windows\

Получение текущего языка и региональных параметров пользовательского интерфейса

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

using System;
using System.Globalization;

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

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

Также можно получить значение языка и региональных параметров пользовательского интерфейса текущего потока из Thread.CurrentUICulture Свойства.

Явное задание текущего языка и региональных параметров пользовательского интерфейса

начиная с платформа .NET Framework 4,6 можно изменить текущий язык и региональные параметры пользовательского интерфейса, назначив CultureInfo свойству объект, представляющий новый язык и региональные параметры CultureInfo.CurrentUICulture . Для текущего языка и региональных параметров пользовательского интерфейса можно задать определенную культуру (например, EN-US или de-DE) или нейтральную культуру (например, EN или de). В следующем примере текущий язык и региональные параметры пользовательского интерфейса устанавливаются в значение fr-FR или французский (Франция).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("The current UI culture: {0}",
                        CultureInfo.CurrentUICulture.Name);

      CultureInfo.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
      Console.WriteLine("The current UI culture: {0}",
                        CultureInfo.CurrentUICulture.Name);
   }
}
// The example displays output like the following:
//       The current UI culture: en-US
//       The current UI culture: fr-FR
Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Console.WriteLine("The current UI culture: {0}", 
                        CultureInfo.CurrentUICulture.Name)
      
      CultureInfo.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Console.WriteLine("The current UI culture: {0}", 
                        CultureInfo.CurrentUICulture.Name)
   End Sub
End Module
' The example displays output like the following:
'       The current UI culture: en-US
'       The current UI culture: fr-FR

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

Неявная установка текущего языка и региональных параметров пользовательского интерфейса

Когда сначала создается поток, включая основной поток приложения, по умолчанию его текущий язык и региональные параметры пользовательского интерфейса устанавливаются следующим образом:

  • С помощью языка и региональных параметров, определенных DefaultThreadCurrentUICulture свойством для текущего домена приложения, если значение свойства не равно null .

  • С использованием языка и региональных параметров по умолчанию для системы. в системах, использующих операционную систему Windows, среда clr вызывает функцию Windows GetUserDefaultUILanguage для задания текущего языка и региональных параметров пользовательского интерфейса. GetUserDefaultUILanguage Возвращает язык и региональные параметры пользовательского интерфейса по умолчанию, заданные пользователем. Если пользователь не установил язык пользовательского интерфейса по умолчанию, он возвращает язык и региональные параметры, установленные в системе изначально.

Если поток пересекает границы приложения и выполняет код в другом домене приложения, его язык и региональные параметры определяются так же, как и у вновь созданного потока.

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

Вопросы безопасности

Для изменения языка и региональных параметров текущего потока требуется SecurityPermission разрешение с ControlThread установленным значением.

Внимание!

Управление потоками опасно из-за состояния безопасности, связанного с потоками. Таким образом, это разрешение должно предоставляться только доверенному коду, а затем только по мере необходимости. Невозможно изменить культуру потока в частично доверяемом коде.

Текущий язык и региональные параметры пользовательского интерфейса и приложения UWP

в приложениях универсальная платформа Windows (UWP) CurrentUICulture свойство доступно для чтения и записи так же, как и в платформа .NET Framework и в приложениях .net Core. его можно использовать для получения и установки текущего языка и региональных параметров. Однако приложения UWP не различают текущий язык и региональные параметры пользовательского интерфейса. CurrentCultureСвойства и CurrentUICulture сопоставляются с первым значением в Windows. Коллекция ApplicationModel. Resources. Core. ResourceManager. Дефаултконтекст. Languages .

в платформа .NET Framework и приложениях .net Core текущий язык и региональные параметры пользовательского интерфейса являются параметром для каждого потока, а CurrentUICulture свойство отражает язык и региональные параметры пользовательского интерфейса только текущего потока. В приложениях UWP текущий язык и региональные параметры сопоставлены с Windows. Свойство ApplicationModel. Resources. Core. ResourceManager. Дефаултконтекст. Languages является глобальным параметром. Установка CurrentCulture свойства изменяет язык и региональные параметры для всего приложения; язык и региональные параметры не могут устанавливаться отдельно для каждого потока.

Применяется к

См. также раздел