System.Globalization.CultureInfo.CurrentUICulture 属性

2025-06-19

本文提供了此 API 参考文档的补充说明。

该 CurrentUICulture 属性是每线程属性。也就是说，每个线程都有自己的当前 UI 文化。此属性等效于检索或设置分配给CultureInfo属性的System.Threading.Thread.CurrentThread.CurrentUICulture对象。启动线程时，其 UI 文化最初确定如下：

如果属性值不是 DefaultThreadCurrentUICulture，则通过检索执行线程所在的应用程序域中由 null 属性指定的区域性。

如果线程是执行基于任务的异步作的线程池线程，并且应用面向 .NET Framework 4.6 或更高版本的 .NET Framework，则其 UI 区域性由调用线程的 UI 区域性确定。以下示例将当前 UI 区域性更改为葡萄牙语（巴西），并启动六个任务，其中每个任务显示其线程 ID、任务 ID 和当前 UI 区域性。每个任务（和线程）都继承了调用线程的 UI 文化设置。

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
    public static async Task Main()
    {
        var tasks = new List<Task>();
        Console.WriteLine($"The current UI culture is {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 {Thread.CurrentThread.CurrentUICulture.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($"UI Culture of task {Task.CurrentId} on thread {Thread.CurrentThread.ManagedThreadId} is {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.Globalization
Imports System.Threading

Module Example1
    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 函数。

若要更改线程使用的用户界面区域性，请将属性 Thread.CurrentUICulture 设置为新区域性。如果以这种方式显式更改线程的 UI 区域性，则当线程跨越应用程序域边界时，该更改将保持不变。

注释

如果将此属性值设为表示新区域性的 CultureInfo 对象，则 Thread.CurrentThread.CurrentCulture 属性的值也会更改。

获取当前的 UI 文化

该 CultureInfo.CurrentUICulture 属性是线程级别的设置，即每个线程都可以有自己的 UI 文化。通过检索 CultureInfo.CurrentUICulture 属性的值来获取当前线程的 UI 文化，如以下示例所示。

using System;
using System.Globalization;

public class Example2
{
    public static void Main()
    {
        CultureInfo culture = CultureInfo.CurrentUICulture;
        Console.WriteLine($"The current UI culture is {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 Example3
    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 属性中检索当前线程的 UI 文化的值。

显式设置当前 UI 文化

从 .NET Framework 4.6 开始，可以通过将表示新文化的 CultureInfo 对象分配给 CultureInfo.CurrentUICulture 属性来更改当前 UI 文化。当前 UI 区域性可以设置为特定区域性（如 en-US 或 de-DE）或中性区域性（例如 en 或 de）。以下示例将当前 UI 文化设置为 fr-FR 或法语（法国）。

using System;
using System.Globalization;

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

        CultureInfo.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
        Console.WriteLine($"The current UI culture: {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

Module Example2
    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 属性来显式设置任何线程的 UI 区域性。如果要设置其区域性的线程是当前线程，则可以将新区域性分配给 CultureInfo.CurrentUICulture 属性。显式设置线程的 UI 区域性时，即使线程跨越应用程序域边界并在另一个应用程序域中执行代码，该线程也会保留相同的区域性。

隐式设置当前 UI 文化

首次创建线程（包括主应用程序线程）时，默认情况下，其当前 UI 区域性设置为如下：

如果属性值不是 DefaultThreadCurrentUICulture，则通过使用当前应用程序域的 null 属性定义的区域性。
通过使用系统的默认区域性。在运行 Windows 操作系统的系统上，公共语言运行时调用 Windows GetUserDefaultUILanguage 函数来设置当前的 UI 文化。 GetUserDefaultUILanguage 返回用户设置的默认用户界面文化。如果用户未设置默认 UI 语言，返回的是系统上初始安装的语言环境。

如果线程跨越应用程序边界并在另一个应用程序域中执行代码，那么其文化信息的确定方式与新创建的线程相同。

请注意，如果设置了不同于系统安装的 UI 区域性或用户的首选 UI 区域性的特定 UI 区域性，并且应用程序启动了多个线程，那么这些线程的当前 UI 区域性将由函数 GetUserDefaultUILanguage 返回的区域性决定，除非你为线程执行所在的应用程序域中的 DefaultThreadCurrentUICulture 属性分配了特定的区域性。

安全注意事项

更改当前线程的区域性需要一个设置了 SecurityPermission 值的 ControlThread 权限。

谨慎

由于与线程关联的安全状态，操作线程是危险的。因此，此权限应仅提供给可信代码，然后仅在必要时提供。不能在半受信任的代码中更改线程文化。

当前 UI 文化和 UWP 应用

在通用 Windows 平台（UWP）应用中，CurrentUICulture 属性是可读写的，就像在 .NET Framework 和 .NET Core 应用中一样，你可以使用它来获取和设置当前文化。但是，UWP 应用不会区分当前文化与当前 UI 文化。 CurrentCulture 和 CurrentUICulture 属性映射到 Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages 集合中的第一个值。

在 .NET Framework 和 .NET Core 应用中，当前 UI 区域性是每线程设置，并且 CurrentUICulture 该属性仅反映当前线程的 UI 区域性。在 UWP 应用中，当前区域性会映射到 Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages 属性，该属性是一个全局设置。 CurrentCulture设置属性会更改整个应用的区域性;区域性不能按线程设置。