Thread.CurrentCulture Propriedade

Definição

Namespace:

System.Threading

Assembly:

System.Threading.Thread.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Obtém ou define a cultura do thread atual.

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 da propriedade

CultureInfo

Um objeto que representa a cultura do thread atual.

Exceções

ArgumentNullException

A propriedade é definida como null.

InvalidOperationException

Somente .NET Core e .NET 5+: não há suporte para leitura ou escrita da cultura de um thread de outro thread.

Exemplos

O exemplo a seguir mostra a instrução threading que permite que a interface do usuário de um aplicativo Windows Forms seja exibida na cultura definida em Painel de Controle. Código adicional é necessário.

#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

Comentários

O objeto retornado por essa propriedade, junto com seus objetos associados, determina o formato padrão para datas, horas, números, valores de moeda, a ordem de classificação de texto, convenções de uso de caixa e comparações de cadeia CultureInfo de caracteres. Consulte a classe para saber mais sobre nomes e identificadores de cultura, as diferenças entre culturas invariáveis, neutras e específicas e a maneira como as informações de cultura afetam threads e CultureInfo domínios de aplicativo. Consulte a propriedade para saber como a cultura padrão de um thread é determinada e como os usuários configuram informações de CultureInfo.CurrentCulture cultura para seus computadores.

Importante

A propriedade não funciona de forma confiável quando CurrentCulture usada com qualquer thread diferente do thread atual. No .NET Framework, ler a propriedade é confiável, embora defini-la para um thread diferente do thread atual não seja. No .NET Core, um será lançado se um thread tentar ler ou InvalidOperationException gravar a propriedade em um thread CurrentCulture diferente. Recomendamos que você use a CultureInfo.CurrentCulture propriedade para recuperar e definir a cultura atual.

A partir do .NET Framework 4, você pode definir CurrentCulture a propriedade como uma cultura neutra. Isso acontece porque o comportamento da classe foi alterado: quando ela representa uma cultura neutra, seus valores de propriedade (em particular, as propriedades , , , e ) agora refletem a cultura específica associada à cultura CultureInfo Calendar CompareInfo DateTimeFormat NumberFormat TextInfo neutra. Em versões anteriores do .NET Framework, a propriedade lançou uma exceção CurrentCulture quando uma cultura neutra foi NotSupportedException atribuída.