Thread.CurrentCulture Propiedad

Definición

Espacio de nombres:

System.Threading

Ensamblado:

System.Threading.Thread.dll

Ensamblado:

netstandard.dll

Ensamblado:

mscorlib.dll

Obtiene o establece la referencia cultural del subproceso actual.

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

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

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

Public Property CurrentCulture As CultureInfo

Valor de propiedad

CultureInfo

Objeto que representa la referencia cultural del subproceso actual.

Excepciones

ArgumentNullException

La propiedad se establece en null.

InvalidOperationException

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 muestra la instrucción de subprocesos que permite que la interfaz de usuario de una aplicación de 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

El objeto devuelto por esta propiedad, junto con sus objetos asociados, determinan el formato predeterminado para fechas, horas, números, valores de moneda, el criterio de ordenación de texto, las convenciones de mayúsculas y minúsculas y las comparaciones de CultureInfo cadenas. 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 un subproceso y cómo los usuarios establecen la información de referencia CultureInfo.CurrentCulture cultural para sus equipos.

Importante

La CurrentCulture 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 CurrentCulture diferente. Se recomienda usar la propiedad CultureInfo.CurrentCulture para recuperar y establecer la referencia cultural actual.

A partir del .NET Framework 4, puede establecer la CurrentCulture propiedad en una referencia cultural neutra. Esto se debe a que el comportamiento de la clase ha cambiado: cuando representa una referencia cultural neutra, sus valores de propiedad (en particular, las propiedades , , , y ) ahora reflejan la referencia cultural específica asociada a la referencia cultural CultureInfo Calendar CompareInfo DateTimeFormat NumberFormat TextInfo neutra. En versiones anteriores de la .NET Framework, la propiedad CurrentCulture generaba una NotSupportedException excepción cuando se asignaba una referencia cultural neutra.