Thread.CurrentUICulture Propiedad

Definición

Obtiene o establece la referencia cultural actual utilizada por el administrador de recursos para buscar recursos específicos de la referencia cultural en tiempo de ejecución.

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

Valor de propiedad

CultureInfo

Objeto que representa la referencia cultural actual.

Excepciones

La propiedad se establece en null.

La propiedad se establece en un nombre de referencia cultural que no se puede usar para buscar un archivo de recursos. Los nombres de archivo de recursos deben incluir solo letras, números, guiones o caracteres de subrayado.

Solo .NET Core y .NET 5+: no se admite la lectura o escritura de la referencia cultural de un subproceso desde otro subproceso.

Ejemplos

En el ejemplo siguiente se determina si el idioma de la referencia cultural de la interfaz de usuario del subproceso actual es francés. Si no es así, establece la referencia cultural de la interfaz de usuario del subproceso actual en inglés (Estados Unidos).

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]
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]

En el ejemplo de código siguiente se muestra la instrucción de subprocesos que permite que la interfaz de usuario de un formulario Windows Forms se muestre en la referencia cultural establecida en Panel de control. Se necesita código adicional.

#using <system.dll>
#using <System.Drawing.dll>
#using <system.windows.forms.dll>

using namespace System;
using namespace System::Threading;
using namespace System::Windows::Forms;
ref class UICulture: public 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.
   }
};


int main()
{
   Application::Run( gcnew UICulture );
}
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());
    }
}
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

Comentarios

La referencia cultural de la interfaz de usuario especifica los recursos que una aplicación necesita para admitir la entrada y salida del usuario y, de forma predeterminada, es la misma que la referencia cultural del sistema operativo. Consulte la clase para obtener información sobre los nombres e identificadores de referencia cultural, las diferencias entre las referencia culturales invariables, neutras y específicas, y la forma en que la información de referencia cultural afecta a los subprocesos y dominios CultureInfo de aplicación. Vea la propiedad para obtener información sobre cómo se determina la referencia cultural predeterminada de la CultureInfo.CurrentUICulture interfaz de usuario de un subproceso.

Importante

La CurrentUICulture propiedad no funciona de forma confiable cuando se usa con cualquier subproceso que no sea el subproceso actual. En .NET Framework, la lectura de la propiedad es confiable, aunque no es posible establecerla para un subproceso distinto del subproceso actual. En .NET Core, InvalidOperationException se produce una excepción si un subproceso intenta leer o escribir la propiedad en un subproceso CurrentUICulture diferente. Se recomienda usar la propiedad CultureInfo.CurrentUICulture para recuperar y establecer la referencia cultural actual.

El CultureInfo devuelto por esta propiedad puede ser una referencia cultural neutra. Las referencia culturales neutras no deben usarse con métodos de formato como String.Format(IFormatProvider, String, Object[]) DateTime.ToString(String, IFormatProvider) , y Convert.ToString(Char, IFormatProvider) . Use el CultureInfo.CreateSpecificCulture método para obtener una referencia cultural específica o use la propiedad CurrentCulture .

Se aplica a