CultureInfo.CurrentCulture Свойство

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

public:
 static property System::Globalization::CultureInfo ^ CurrentCulture { System::Globalization::CultureInfo ^ get(); };

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

public static System.Globalization.CultureInfo CurrentCulture { get; }

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

static member CurrentCulture : System.Globalization.CultureInfo

Public Shared Property CurrentCulture As CultureInfo

Public Shared ReadOnly Property CurrentCulture As CultureInfo

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

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

Исключения

Примеры

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

using System;
using System.Globalization;

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 Example2
   Public Sub Run()
      ' 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.

Комментарии

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

Текущая культура — это свойство выполняемого потока. При установке этого свойства объекту CultureInfo, представляющему новую культуру, значение свойства Thread.CurrentThread.CurrentCulture также изменяется. Однако мы рекомендуем всегда использовать свойство CultureInfo.CurrentCulture для получения и задания текущей культуры.

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

Как определяется культура потока

При запуске потока его культура изначально определяется следующим образом:

• Извлекая культуру, указанную свойством DefaultThreadCurrentCulture в домене приложения, в котором выполняется поток, если значение свойства не null.

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

  using System;
  using System.Collections.Generic;
  using System.Globalization;
  using System.Threading;
  using System.Threading.Tasks;
  
  public class Example14
  {
      public static async Task Main()
      {
          var tasks = new List<Task>();
          Console.WriteLine($"The current culture is {Thread.CurrentThread.CurrentCulture.Name}");
          Thread.CurrentThread.CurrentCulture = new CultureInfo("pt-BR");
          // Change the current culture to Portuguese (Brazil).
          Console.WriteLine($"Current culture changed to {Thread.CurrentThread.CurrentCulture.Name}");
          Console.WriteLine($"Application thread is thread {Thread.CurrentThread.ManagedThreadId}");
          // Launch six tasks and display their current culture.
          for (int ctr = 0; ctr <= 5; ctr++)
              tasks.Add(Task.Run(() =>
              {
                  Console.WriteLine($"Culture of task {Task.CurrentId} on thread {Thread.CurrentThread.ManagedThreadId} is {Thread.CurrentThread.CurrentCulture.Name}");
              }));
  
          await Task.WhenAll(tasks.ToArray());
      }
  }
  
  // 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
  

  Imports System.Globalization
  Imports System.Threading
  
  Module Example1
      Public Sub S1()
          Dim tasks As New List(Of Task)
          Console.WriteLine("The current culture is {0}",
                          Thread.CurrentThread.CurrentCulture.Name)
          Thread.CurrentThread.CurrentCulture = New CultureInfo("pt-BR")
          ' Change the current culture to Portuguese (Brazil).
          Console.WriteLine("Current culture changed to {0}",
                          Thread.CurrentThread.CurrentCulture.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.CurrentCulture.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
  

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

• Вызывая функцию GetUserDefaultLocaleName в Windows или функцию uloc_getDefault из ICU на системах, таких как Unix, которая в настоящее время вызывает функцию POSIX setlocale с категорией LC_MESSAGES,

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

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

Получение текущей культуры

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

using System;
using System.Globalization;

public class Example5
{
   public static void Main()
   {
      CultureInfo culture = CultureInfo.CurrentCulture;
      Console.WriteLine($"The current culture is {culture.NativeName} [{culture.Name}]");
   }
}

// The example displays output like the following:
//       The current culture is English (United States) [en-US]

Imports System.Globalization

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

Явно задать свойство CurrentCulture

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

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

public class Info11 : MarshalByRefObject
{
    public void ShowCurrentCulture()
    {
        Console.WriteLine($"Culture of thread {Thread.CurrentThread.Name}: {CultureInfo.CurrentCulture.Name}");
    }
}

public class SetCultureExample
{
    public static void Run()
    {
        Info11 inf = new Info11();
        // Set the current culture to Dutch (Netherlands).
        Thread.CurrentThread.Name = "MainThread";
        CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture("nl-NL");
        inf.ShowCurrentCulture();
    }
}

// The example displays the following output:
//
//     Culture of thread MainThread: nl-NL

Вы можете явно изменить текущий язык и региональные параметры на определенный язык и региональные параметры (например, французский (Канада)) или нейтральный язык и региональные параметры (например, французский). CultureInfo Когда объект представляет нейтральную культуру, значения свойств, таких как CultureInfo, Calendar, CompareInfo, DateTimeFormat, NumberFormat и TextInfo, отражают конкретную культуру, связанную с нейтральной культурой. Например, доминирующая культура для английского нейтрального языка — английский (США); доминирующей культурой для немецкой культуры является немецкий (Германия). В следующем примере продемонстрировано различие в форматировании, когда текущая культура установлена на конкретную культуру, французская (Канада), и на нейтральную культуру, французская.

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

public class Example12
{
   public static void Main()
   {
      double value = 1634.92;
      CultureInfo.CurrentCulture = new CultureInfo("fr-CA");
      Console.WriteLine($"Current Culture: {CultureInfo.CurrentCulture.Name}");
      Console.WriteLine($"{value:C2}\n");

      Thread.CurrentThread.CurrentCulture = new CultureInfo("fr");
      Console.WriteLine($"Current Culture: {CultureInfo.CurrentCulture.Name}");
      Console.WriteLine($"{value:C2}");
   }
}

// The example displays the following output:
//       Current Culture: fr-CA
//       1 634,92 $
//
//       Current Culture: fr
//       1 634,92 €

Imports System.Globalization
Imports System.Threading

Module Example4
    Public Sub S1()
        Dim value As Double = 1634.92
        CultureInfo.CurrentCulture = New CultureInfo("fr-CA")
        Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name)
        Console.WriteLine("{0:C2}", value)
        Console.WriteLine()

        Thread.CurrentThread.CurrentCulture = New CultureInfo("fr")
        Console.WriteLine("Current Culture: {0}",
                        CultureInfo.CurrentCulture.Name)
        Console.WriteLine("{0:C2}", value)
    End Sub
End Module
' The example displays the following output:
'       Current Culture: fr-CA
'       1 634,92 $
'       
'       Current Culture: fr
'       1 634,92 €

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

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

• Если языковые и региональные параметры текущего потока задаются неявно с помощью функции Windows GetUserDefaultLocaleName.
• Если текущий язык и региональные параметры потока, определенные DefaultThreadCurrentCulture свойством, соответствуют текущему языку и региональных параметров системы Windows.
• Если текущие региональные настройки потока явно заданы культурам, возвращаемым методом CreateSpecificCulture, и эти настройки соответствуют текущей культуре системы Windows.
• Если текущий язык и региональные параметры потока заданы явным образом в качестве экземпляра языка и региональных параметров, созданных CultureInfo(String) конструктором, и этот язык и региональные параметры соответствуют текущему языку и региональных параметров системы Windows.

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

• Вызывая конструктор CultureInfo(String, Boolean) со значением false для аргумента useUserOverride.
• При вызове метода GetCultureInfo, который возвращает кэшированный объект CultureInfo, доступный только для чтения.

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

• DefaultThreadCurrentCulture
• CurrentCulture
• CurrentUICulture
• InstalledUICulture
• InvariantCulture
• Parent
• SecurityPermission
• SecurityPermissionAttribute