CultureInfo.CurrentCulture 属性

定义

命名空间:
System.Globalization
程序集:
mscorlib.dll, System.Globalization.dll
程序集:
netstandard.dll, System.Runtime.dll
程序集:
System.Globalization.dll
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs
Source:
CultureInfo.cs

获取或设置 CultureInfo 表示当前线程和基于任务的异步操作使用的区域性的对象。

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

属性值

CultureInfo

当前线程和基于任务的异步操作使用的区域性。

例外

ArgumentNullException

属性设置为 null.

示例

以下示例演示如何更改 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 属性指定的区域性。

  • 如果线程是线程池线程，正在执行基于任务的异步操作，则其区域性由调用线程的区域性确定。 以下示例将当前区域性更改为葡萄牙语（巴西），并启动六个任务，其中每个任务显示其线程 ID、任务 ID 和当前区域性。 每个任务（和线程）都继承了调用线程的区域性。

    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

    有关详细信息，请参阅区域性与任务型异步操作。

  • 通过在 Windows 上调用GetUserDefaultLocaleName函数或通过uloc_getDefault中的函数在类似 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.CurrentCulture 属性来更改区域性需拥有 SecurityPermission 权限并设置 ControlThread 值。 由于与线程关联的安全状态，操作线程是危险的。 因此，此权限应仅提供给可信代码，然后仅在必要时提供。 不能在半受信任的代码中更改线程文化。

可以将当前线程区域性显式更改为特定区域性（如法语（如法语（加拿大）或中性文化（如法语）。 当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 对象：

适用于

另请参阅