CultureInfo.DefaultThreadCurrentUICulture Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cultura padrão interface do usuário para threads no domínio do aplicativo atual.
public:
static property System::Globalization::CultureInfo ^ DefaultThreadCurrentUICulture { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };public static System.Globalization.CultureInfo DefaultThreadCurrentUICulture { get; set; }public static System.Globalization.CultureInfo? DefaultThreadCurrentUICulture { get; set; }member this.DefaultThreadCurrentUICulture : System.Globalization.CultureInfo with get, setPublic Shared Property DefaultThreadCurrentUICulture As CultureInfoValor da propriedade
A cultura padrão da interface do usuário para threads no domínio do aplicativo atual ou null se a cultura da interface do usuário do sistema atual for a cultura padrão para threads da interface do usuário no domínio do aplicativo.
Exceções
Em uma operação de conjuntos, o valor da propriedade Name é inválido.
Exemplos
o exemplo a seguir ilustra o comportamento padrão do .NET Framework na definição da cultura atual de um novo thread. Ele usa recursos de idioma inglês e russo. O seguinte arquivo de texto chamado GreetingStrings.txt contém os recursos do idioma inglês:
greeting =Hello again!
newGreeting=Hello!
Ele é compilado em um arquivo binary. Resources chamado GreetingStrings. Resources usando o gerador de arquivo de recursos com o comando a seguir.
resgen greetingstrings.txt
O seguinte arquivo de texto chamado GreetingStrings.ru-RU.txt contém os recursos de idioma russo:
greeting=Еще раз привет!
newGreeting=Привет!
Ele é compilado em um arquivo binary. Resources chamado GreetingStrings.ru-RU. Resources usando o gerador do arquivo de recursos com o comando a seguir.
resgen greetingstrings.ru-RU.txt
O código do aplicativo, que é mostrado abaixo, reside em um arquivo chamado example1. vb ou example1. cs. ele é compilado em um executável usando o seguinte comando para o compilador de Visual Basic:
vbc Example1.vb /resource:GreetingStrings.resources
Para o compilador C#, o comando é semelhante:
csc /resource:GreetingStrings.resources Example1.cs
Isso cria um assembly que inclui o código executável do exemplo junto com os recursos para sua cultura de fallback. Você também pode usar o vinculador de assembly para criar o arquivo de recurso para a cultura russa (Rússia) com o seguinte comando:
>al /embed:greetingstrings.ru-RU.resources /c:ru-RU /template:example1.exe /out:ru-RU\Example1.resources.dll
Na inicialização, o exemplo define a cultura atual e a cultura da interface do usuário atual como russo (Rússia) em todos os sistemas, exceto aquelas em que a cultura do sistema padrão já é russo (Rússia). Se a cultura do sistema padrão já for russo (Rússia), o código definirá a cultura atual e a cultura da interface do usuário atual como Inglês (Estados Unidos). Em seguida, ele chama a ShowGreeting rotina, que exibe uma cadeia de caracteres simples na primeira vez que é chamada e uma cadeia de caracteres ligeiramente diferente em chamadas de método subsequentes. Em seguida, ele cria um novo thread, que também executa a ShowGreeting rotina.
using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;
[assembly:NeutralResourcesLanguageAttribute("en-US")]
public class Example
{
private static int nGreetings = 0;
private static ResourceManager rm;
public static void Main()
{
AppDomain domain = AppDomain.CurrentDomain;
rm = new ResourceManager("GreetingStrings",
typeof(Example).Assembly);
CultureInfo culture = null;
if (Thread.CurrentThread.CurrentUICulture.Name == "ru-RU")
culture = CultureInfo.CreateSpecificCulture("en-US");
else
culture = CultureInfo.CreateSpecificCulture("ru-RU");
Thread.CurrentThread.CurrentCulture = culture;
Thread.CurrentThread.CurrentUICulture = culture;
ShowGreeting();
Thread.Sleep(1000);
Thread workerThread = new Thread(Example.ShowGreeting);
workerThread.Start();
}
private static void ShowGreeting()
{
string greeting = nGreetings == 0 ? rm.GetString("newGreeting") :
rm.GetString("greeting");
nGreetings++;
Console.WriteLine("{0}", greeting);
}
}
// The example displays the following output:
// Привет!
// Hello again!
Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading
<Assembly:NeutralResourcesLanguageAttribute("en-US")>
Public Class Example
Private Shared nGreetings As Integer = 0
Private Shared rm As ResourceManager
Public Shared Sub Main()
Dim domain As AppDomain = AppDomain.CurrentDomain
rm = New ResourceManager("GreetingStrings",
GetType(Example).Assembly)
Dim culture As CultureInfo = Nothing
If Thread.CurrentThread.CurrentUICulture.Name = "ru-RU" Then
culture = CultureInfo.CreateSpecificCulture("en-US")
Else
culture = CultureInfo.CreateSpecificCulture("ru-RU")
End If
Thread.CurrentThread.CurrentCulture = culture
Thread.CurrentThread.CurrentUICulture = culture
ShowGreeting()
Thread.Sleep(1000)
Dim workerThread As New Thread(AddressOf Example.ShowGreeting)
workerThread.Start()
End Sub
Private Shared Sub ShowGreeting()
Dim greeting As String = CStr(IIf(nGreetings = 0,
rm.GetString("newGreeting"),
rm.GetString("greeting")))
nGreetings += 1
Console.WriteLine("{0}", greeting)
End Sub
End Class
' The example displays the following output:
' Привет!
' Hello again!
Como a saída do exemplo mostra, quando o exemplo é executado em um computador cuja cultura do sistema é inglês (Estados Unidos), o thread principal exibe sua cadeia de caracteres inicial em Russo. no entanto, como a cultura do thread de trabalho é derivada da cultura do sistema Windows atual em vez da cultura atual do aplicativo, o thread de trabalho exibe sua cadeia de caracteres em inglês.
O exemplo a seguir usa DefaultThreadCurrentCulture as DefaultThreadCurrentUICulture Propriedades e para definir a cultura atual e a cultura da interface do usuário atual de um novo thread de aplicativo.
O exemplo usa os mesmos arquivos de recursos do exemplo anterior. Os comandos para compilar e inserir os recursos de idioma russo localizados em um assembly satélite também são idênticos, exceto pelo fato de o nome do assembly executável ser alterado.
Na inicialização, o exemplo define a cultura atual e a cultura da interface do usuário atual como russo (Rússia) em todos os sistemas, exceto aquelas em que a cultura do sistema padrão já é russo (Rússia). Se a cultura do sistema padrão já for russo (Rússia), ela definirá a cultura atual e a cultura da interface do usuário atual como Inglês (Estados Unidos). Em seguida, ele chama a ShowGreeting rotina, que exibe uma cadeia de caracteres simples na primeira vez que é chamada e uma cadeia de caracteres ligeiramente diferente em chamadas de método subsequentes. Em seguida, ele cria um novo thread, que também executa a ShowGreeting rotina.
using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;
[assembly:NeutralResourcesLanguageAttribute("en-US")]
public class Example
{
private static int nGreetings = 0;
private static ResourceManager rm;
public static void Main()
{
AppDomain domain = AppDomain.CurrentDomain;
rm = new ResourceManager("GreetingStrings",
typeof(Example).Assembly);
CultureInfo culture = null;
if (Thread.CurrentThread.CurrentUICulture.Name == "ru-RU")
culture = CultureInfo.CreateSpecificCulture("en-US");
else
culture = CultureInfo.CreateSpecificCulture("ru-RU");
CultureInfo.DefaultThreadCurrentCulture = culture;
CultureInfo.DefaultThreadCurrentUICulture = culture;
Thread.CurrentThread.CurrentCulture = culture;
Thread.CurrentThread.CurrentUICulture = culture;
ShowGreeting();
Thread.Sleep(1000);
Thread workerThread = new Thread(Example.ShowGreeting);
workerThread.Start();
}
private static void ShowGreeting()
{
string greeting = nGreetings == 0 ? rm.GetString("newGreeting") :
rm.GetString("greeting");
nGreetings++;
Console.WriteLine("{0}", greeting);
}
}
// The example displays the following output:
// Привет!
// Еще раз привет!
Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading
<Assembly:NeutralResourcesLanguageAttribute("en-US")>
Public Class Example
Private Shared nGreetings As Integer = 0
Private Shared rm As ResourceManager
Public Shared Sub Main()
Dim domain As AppDomain = AppDomain.CurrentDomain
rm = New ResourceManager("GreetingStrings",
GetType(Example).Assembly)
Dim culture As CultureInfo = Nothing
If Thread.CurrentThread.CurrentUICulture.Name = "ru-RU" Then
culture = CultureInfo.CreateSpecificCulture("en-US")
Else
culture = CultureInfo.CreateSpecificCulture("ru-RU")
End If
CultureInfo.DefaultThreadCurrentCulture = culture
CultureInfo.DefaultThreadCurrentUICulture = culture
Thread.CurrentThread.CurrentCulture = culture
Thread.CurrentThread.CurrentUICulture = culture
ShowGreeting()
Thread.Sleep(1000)
Dim workerThread As New Thread(AddressOf Example.ShowGreeting)
workerThread.Start()
End Sub
Private Shared Sub ShowGreeting()
Dim greeting As String = CStr(IIf(nGreetings = 0,
rm.GetString("newGreeting"),
rm.GetString("greeting")))
nGreetings += 1
Console.WriteLine("{0}", greeting)
End Sub
End Class
' The example displays the following output:
' Привет!
' Еще раз привет!
Como a saída do exemplo mostra, quando o exemplo é executado em um computador cuja cultura do sistema é inglês (Estados Unidos), o thread principal e o thread de trabalho exibem suas cadeias de caracteres no idioma russo.
Comentários
no .NET Framework 4 e versões anteriores, por padrão, a cultura da interface do usuário de todos os threads é definida como a cultura do sistema Windows. Para aplicativos cuja cultura da interface do usuário atual difere da cultura do sistema padrão, esse comportamento geralmente é indesejável. no .NET Framework 4,5, a DefaultThreadCurrentUICulture propriedade permite que você defina a cultura da interface do usuário padrão de todos os threads em um domínio de aplicativo.
Importante
Se você não definiu explicitamente a cultura da interface do usuário de quaisquer threads existentes em execução em um domínio de aplicativo, a definição da DefaultThreadCurrentUICulture propriedade também alterará a cultura desses threads. No entanto, se esses threads forem executados em outro domínio de aplicativo, sua cultura será definida pela DefaultThreadCurrentUICulture Propriedade nesse domínio de aplicativo ou, se nenhum valor padrão for definido, pela cultura de sistema padrão. Por isso, é recomendável que você sempre defina explicitamente a cultura do seu thread de aplicativo principal e não confie na DefaultThreadCurrentUICulture propriedade para definir a cultura do thread do aplicativo principal.
a menos que seja definido explicitamente, o valor da DefaultThreadCurrentUICulture propriedade é null , e a cultura atual de todos os threads em um domínio de aplicativo que não tenha sido atribuído a uma cultura explícita é definida pela cultura de sistema Windows padrão.
Para obter mais informações sobre culturas, threads e domínios de aplicativo, consulte as seções "cultura e threads" e "domínios de aplicativo e cultura" na CultureInfo página de referência.