Condividi tramite


CultureInfo.DefaultThreadCurrentUICulture Proprietà

Definizione

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.

Si applica a

Vedi anche