CultureInfo.DefaultThreadCurrentUICulture Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta le impostazioni cultura predefinite dell'interfaccia utente per i thread nel dominio applicazione corrente.
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; }
static member DefaultThreadCurrentUICulture : System.Globalization.CultureInfo with get, set
Public Shared Property DefaultThreadCurrentUICulture As CultureInfo
Valore della proprietà
Le impostazioni cultura predefinite dell'interfaccia utente per i thread nel dominio applicazione corrente o null se le impostazioni cultura dell'interfaccia utente di sistema correnti sono le impostazioni cultura predefinite dell'interfaccia utente del thread nel dominio applicazione.
Eccezioni
In un'operazione set il valore della Name proprietà non è valido.
Esempio
Nell'esempio seguente viene illustrato il comportamento predefinito di .NET nella definizione delle impostazioni cultura correnti di un nuovo thread. Usa risorse in lingua inglese e russa. Il file di testo seguente denominato GreetingStrings.txt contiene le risorse della lingua inglese:
greeting =Hello again!
newGreeting=Hello!
Viene compilato in un file binario con estensione resources denominato GreetingStrings.resources usando il generatore di file di risorse con il comando seguente.
resgen greetingstrings.txt
Il file di testo seguente denominato GreetingStrings.ru-RU.txt contiene le risorse in lingua russa:
greeting=Еще раз привет!
newGreeting=Привет!
Viene compilato in un file binario con estensione resources denominato GreetingStrings.ru-RU.resources usando il generatore di file di risorse con il comando seguente.
resgen greetingstrings.ru-RU.txt
Il codice dell'applicazione, illustrato di seguito, si trova in un file denominato Example1.vb o Example1.cs. Viene compilato in un eseguibile usando il comando seguente per il compilatore Visual Basic:
vbc Example1.vb /resource:GreetingStrings.resources
Per il compilatore C#, il comando è simile al seguente:
csc /resource:GreetingStrings.resources Example1.cs
Verrà creato un assembly che include il codice eseguibile dell'esempio insieme alle risorse per le impostazioni cultura di fallback. È anche possibile usare Assembly Linker per creare il file di risorse per le impostazioni cultura russe (Russia) con il comando seguente:
>al /embed:greetingstrings.ru-RU.resources /c:ru-RU /template:example1.exe /out:ru-RU\Example1.resources.dll
All'avvio, l'esempio imposta le impostazioni cultura correnti e le impostazioni cultura dell'interfaccia utente correnti su Russo (Russia) su tutti i sistemi, ad eccezione di quelli in cui le impostazioni cultura di sistema predefinite sono già russe (Russia). Se le impostazioni cultura di sistema predefinite sono già russe (Russia), il codice imposta le impostazioni cultura correnti e le impostazioni cultura correnti dell'interfaccia utente su Inglese (Stati Uniti). Chiama quindi la ShowGreeting routine , che visualizza una stringa semplice la prima volta che viene chiamata e una stringa leggermente diversa nelle chiamate di metodo successive. Successivamente, crea un nuovo thread, che esegue anche la ShowGreeting routine.
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!
Come illustrato nell'output dell'esempio, quando l'esempio viene eseguito in un computer le cui impostazioni cultura di sistema sono inglese (Stati Uniti), il thread principale visualizza la stringa iniziale in russo. Tuttavia, poiché le impostazioni cultura del thread di lavoro derivano dalle impostazioni cultura correnti di sistema di Windows anziché dalle impostazioni cultura correnti dell'applicazione, il thread di lavoro visualizza la stringa in inglese.
Nell'esempio seguente vengono usate le DefaultThreadCurrentCulture proprietà e DefaultThreadCurrentUICulture per definire le impostazioni cultura correnti e le impostazioni cultura correnti dell'interfaccia utente di un nuovo thread applicazione.
Nell'esempio vengono usati gli stessi file di risorse dell'esempio precedente. Anche i comandi da compilare e per incorporare le risorse in lingua russa localizzate in un assembly satellite sono identici, ad eccezione del fatto che il nome dell'assembly eseguibile cambia.
All'avvio, l'esempio imposta le impostazioni cultura correnti e le impostazioni cultura dell'interfaccia utente correnti su Russo (Russia) su tutti i sistemi, ad eccezione di quelli in cui le impostazioni cultura di sistema predefinite sono già russe (Russia). Se le impostazioni cultura di sistema predefinite sono già russe (Russia), imposta le impostazioni cultura correnti e le impostazioni cultura correnti dell'interfaccia utente su Inglese (Stati Uniti). Chiama quindi la ShowGreeting routine , che visualizza una stringa semplice la prima volta che viene chiamata e una stringa leggermente diversa nelle chiamate di metodo successive. Successivamente, crea un nuovo thread, che esegue anche la ShowGreeting routine.
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:
' Привет!
' Еще раз привет!
Come illustrato nell'output dell'esempio, quando l'esempio viene eseguito in un computer le cui impostazioni cultura di sistema sono inglese (Stati Uniti), sia il thread principale che il thread di lavoro visualizzano le stringhe nella lingua russa.
Commenti
Per impostazione predefinita, in .NET Framework 4 e versioni precedenti le impostazioni cultura dell'interfaccia utente di tutti i thread sono impostate sulle impostazioni cultura di sistema di Windows. Per le applicazioni le cui impostazioni cultura dell'interfaccia utente correnti differiscono dalle impostazioni cultura predefinite del sistema, questo comportamento è spesso indesiderato. In .NET Framework 4.5+, la DefaultThreadCurrentUICulture proprietà consente di definire le impostazioni cultura predefinite dell'interfaccia utente di tutti i thread in un dominio applicazione.
Importante
Se non sono state impostate in modo esplicito le impostazioni cultura dell'interfaccia utente di qualsiasi thread esistente in esecuzione in un dominio applicazione, l'impostazione della DefaultThreadCurrentUICulture proprietà modifica anche le impostazioni cultura di questi thread. Tuttavia, se questi thread vengono eseguiti in un altro dominio applicazione, le DefaultThreadCurrentUICulture impostazioni cultura vengono definite dalla proprietà nel dominio applicazione o, se non è definito alcun valore predefinito, dalle impostazioni cultura di sistema predefinite. Per questo motivo, è consigliabile impostare sempre in modo esplicito le impostazioni cultura del thread applicazione principale e non basarsi sulla DefaultThreadCurrentUICulture proprietà per definire le impostazioni cultura del thread applicazione principale.
A meno che non sia impostato in modo esplicito, il valore della DefaultThreadCurrentUICulture proprietà è nulle le impostazioni cultura correnti di tutti i thread in un dominio applicazione a cui non sono state assegnate impostazioni cultura esplicite vengono definite dalle impostazioni cultura predefinite del sistema di Windows.
Per altre informazioni su impostazioni cultura, thread e domini applicazione, vedere le sezioni "Impostazioni cultura e thread" e "Impostazioni cultura e domini applicazione" di CultureInfo.