Thread.CurrentUICulture Proprietà

Definizione

Spazio dei nomi:

System.Threading

Assembly:

netstandard.dll, System.Threading.Thread.dll

Origine:

Thread.cs

Ottiene o imposta le impostazioni cultura correnti usate da Resource Manager per cercare risorse specifiche delle impostazioni cultura in fase di esecuzione.

public:
 property System::Globalization::CultureInfo ^ CurrentUICulture { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };

public System.Globalization.CultureInfo CurrentUICulture { get; set; }

member this.CurrentUICulture : System.Globalization.CultureInfo with get, set

Public Property CurrentUICulture As CultureInfo

Valore della proprietà

CultureInfo

Oggetto che rappresenta le impostazioni cultura correnti.

Eccezioni

ArgumentNullException

La proprietà è impostata su null.

ArgumentException

La proprietà è impostata su un nome delle impostazioni cultura che non può essere utilizzato per individuare un file di risorse. I nomi file di risorse devono includere solo lettere, numeri, trattini o caratteri di sottolineatura.

InvalidOperationException

Solo .NET Core e .NET 5+: la lettura o la scrittura delle impostazioni cultura di un thread da un altro thread non è supportata.

Esempio

L'esempio seguente determina se la lingua delle impostazioni cultura dell'interfaccia utente del thread corrente è francese. In caso contrario, imposta le impostazioni cultura dell'interfaccia utente del thread corrente su Inglese (Stati Uniti).

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      // Change the current culture if the language is not French.
      CultureInfo current = Thread.CurrentThread.CurrentUICulture;
      if (current.TwoLetterISOLanguageName != "fr") {
         CultureInfo newCulture = CultureInfo.CreateSpecificCulture("en-US");
         Thread.CurrentThread.CurrentUICulture = newCulture;
         // Make current UI culture consistent with current culture.
         Thread.CurrentThread.CurrentCulture = newCulture;
      }
      Console.WriteLine("The current UI culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name);
      Console.WriteLine("The current culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name);
   }
}
// The example displays the following output:
//     The current UI culture is English (United States) [en-US]
//     The current culture is English (United States) [en-US]

open System.Globalization
open System.Threading

// Change the current culture if the language is not French.
let current = Thread.CurrentThread.CurrentUICulture

if current.TwoLetterISOLanguageName <> "fr" then
    let newCulture = CultureInfo.CreateSpecificCulture "en-US"
    Thread.CurrentThread.CurrentUICulture <- newCulture
    // Make current UI culture consistent with current culture.
    Thread.CurrentThread.CurrentCulture <- newCulture

printfn
    $"The current UI culture is {Thread.CurrentThread.CurrentUICulture.NativeName} [{Thread.CurrentThread.CurrentUICulture.Name}]"

printfn
    $"The current culture is {Thread.CurrentThread.CurrentUICulture.NativeName} [{Thread.CurrentThread.CurrentUICulture.Name}]"

// The example displays the following output:
//     The current UI culture is English (United States) [en-US]
//     The current culture is English (United States) [en-US]

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      ' Change the current culture if the language is not French.
      Dim current As CultureInfo = Thread.CurrentThread.CurrentUICulture
      If current.TwoLetterISOLanguageName <> "fr" Then
         Dim newCulture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
         Thread.CurrentThread.CurrentUICulture = newCulture
         ' Make current UI culture consistent with current culture.
         Thread.CurrentThread.CurrentCulture = newCulture
      End If
      Console.WriteLine("The current UI culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name)
      Console.WriteLine("The current culture is {0} [{1}]",
                        Thread.CurrentThread.CurrentUICulture.NativeName,
                        Thread.CurrentThread.CurrentUICulture.Name)
   End Sub
End Module
' The example displays output like the following:
'     The current UI culture is English (United States) [en-US]
'     The current culture is English (United States) [en-US]

Nell'esempio di codice seguente viene illustrata l'istruzione threading che consente all'interfaccia utente di un Windows Form di visualizzare le impostazioni cultura impostate nel Pannello di controllo. È necessario codice aggiuntivo.

using System;
using System.Threading;
using System.Windows.Forms;

class UICulture : Form
{
    public UICulture()
    {
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = 
            Thread.CurrentThread.CurrentCulture;

        // Add additional code.
    }

    static void Main()
    {
        Application.Run(new UICulture());
    }
}

open System.Threading
open System.Windows.Forms

type UICulture() =
    inherit Form()

    do
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture <- Thread.CurrentThread.CurrentCulture

// Add additional code.

new UICulture() |> Application.Run

Imports System.Threading
Imports System.Windows.Forms

Public Class UICulture : Inherits Form
    Sub New()

        ' Set the user interface to display in the
        ' same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = _
            Thread.CurrentThread.CurrentCulture

        ' Add additional code.
    End Sub

    Shared Sub Main()
        Application.Run(New UICulture())
    End Sub
End Class

Commenti

Le impostazioni cultura dell'interfaccia utente specificano le risorse che un'applicazione deve supportare l'input e l'output dell'utente e, per impostazione predefinita, corrisponde alle impostazioni cultura del sistema operativo. Vedere la CultureInfo classe per informazioni sui nomi e gli identificatori delle impostazioni cultura, sulle differenze tra impostazioni cultura invarianti, neutre e specifiche e sul modo in cui le informazioni sulle impostazioni cultura influiscono sui thread e sui domini applicazione. Vedere la CultureInfo.CurrentUICulture proprietà per informazioni su come vengono determinate le impostazioni cultura predefinite dell'interfaccia utente di un thread.

Importante

La CurrentUICulture proprietà non funziona in modo affidabile se usata con qualsiasi thread diverso dal thread corrente. In .NET Framework la lettura della proprietà è affidabile, anche se l'impostazione per un thread diverso dal thread corrente non è. In .NET Core viene generata un'eccezione InvalidOperationException se un thread tenta di leggere o scrivere la CurrentUICulture proprietà in un thread diverso. È consigliabile usare la CultureInfo.CurrentUICulture proprietà per recuperare e impostare le impostazioni cultura correnti.

L'oggetto CultureInfo restituito da questa proprietà può essere una lingua neutra. Le impostazioni cultura neutre non devono essere usate con metodi di formattazione come String.Format(IFormatProvider, String, Object[]), DateTime.ToString(String, IFormatProvider)e Convert.ToString(Char, IFormatProvider). Utilizzare il CultureInfo.CreateSpecificCulture metodo per ottenere impostazioni cultura specifiche o usare la CurrentCulture proprietà .