Thread.CurrentCulture Свойство

Определение

Пространство имен:

System.Threading

Сборка:

System.Threading.Thread.dll

Сборка:

netstandard.dll

Сборка:

mscorlib.dll

Получает или задает язык и региональные параметры для текущего потока.

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

Значение свойства

CultureInfo

Объект, представляющий язык и региональные параметры, используемые текущим потоком.

Исключения

ArgumentNullException

Для свойства задано значение null.

InvalidOperationException

.NET Core и .NET 5 + только: чтение или запись языка и региональных параметров потока из другого потока не поддерживается.

Примеры

в следующем примере показана потоковая инструкция, которая позволяет пользовательскому интерфейсу приложения Windows Forms отображаться в культуре, заданной в панели управления. Требуется дополнительный код.

#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

Комментарии

CultureInfoОбъект, возвращаемый этим свойством вместе со связанными с ним объектами, определяет формат по умолчанию для дат, времени, чисел, значений валют, порядок сортировки текста, соглашения о регистре и сравнения строк. Ознакомьтесь с CultureInfo классом, чтобы узнать об именах и идентификаторах культур, различиях между инвариантными, нейтральными и конкретными культурами, а также о том, как язык и региональные параметры влияют на потоки и домены приложений. Ознакомьтесь со CultureInfo.CurrentCulture свойством, чтобы узнать, как определяется язык и региональные параметры по умолчанию потока, и как пользователи задают сведения о культуре для своих компьютеров.

Важно!

CurrentCultureСвойство не работает надежно при использовании в любом потоке, отличном от текущего потока. в платформа .NET Framework чтение свойства является надежным, хотя его задание для потока, отличного от текущего потока, — нет. В .NET Core InvalidOperationException создается исключение, если поток пытается прочитать или записать CurrentCulture свойство в другом потоке. CultureInfo.CurrentCultureДля получения и задания текущего языка и региональных параметров рекомендуется использовать свойство.

начиная с платформа .NET Framework 4, свойству можно присвоить значение CurrentCulture нейтрального языка и региональных параметров. Это связано с тем, что поведение CultureInfo класса изменилось: когда он представляет нейтральную культуру, значения его свойств (в частности, Calendar свойства,,, CompareInfo DateTimeFormat NumberFormat и TextInfo ) теперь отражать конкретную культуру, связанную с нейтральным языком и региональными параметрами. в более ранних версиях платформа .NET Framework CurrentCulture свойство вызвало NotSupportedException исключение при назначении нейтрального языка и региональных параметров.