Thread.CurrentCulture Eigenschaft

Definition

Namespace:

System.Threading

Assembly:

System.Threading.Thread.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Ruft die Kultur für den aktuellen Thread ab oder legt diese fest.

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

Eigenschaftswert

CultureInfo

Ein Objekt, das die Kultur für den aktuellen Thread darstellt.

Ausnahmen

ArgumentNullException

Die Eigenschaft ist auf null festgelegt.

InvalidOperationException

Nur .NET Core und .NET 5 und mehr: Das Lesen oder Schreiben der Kultur eines Threads aus einem anderen Thread wird nicht unterstützt.

Beispiele

Das folgende Beispiel zeigt die Threading-Anweisung, mit der die Benutzeroberfläche einer Windows Forms-Anwendung in der Kultur angezeigt werden kann, die in Systemsteuerung. Zusätzlicher Code ist erforderlich.

#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

Hinweise

Das -Objekt, das von dieser Eigenschaft zusammen mit den zugeordneten -Objekten zurückgegeben wird, bestimmt das Standardformat für Datumsangaben, Zeiten, Zahlen, Währungswerte, die Sortierreihenfolge von Text, Groß-/Kleinraumkonventionen und CultureInfo Zeichenfolgenvergleiche. In der -Klasse erfahren Sie mehr über Kulturnamen und -bezeichner, die Unterschiede zwischen invarianten, neutralen und bestimmten Kulturen und die Auswirkungen von Kulturinformationen auf Threads CultureInfo und Anwendungsdomänen. In der -Eigenschaft erfahren Sie, wie die Standardkultur eines Threads bestimmt wird und wie Benutzer CultureInfo.CurrentCulture Kulturinformationen für ihre Computer festlegen.

Wichtig

Die CurrentCulture -Eigenschaft funktioniert nicht zuverlässig, wenn sie mit einem anderen Thread als dem aktuellen Thread verwendet wird. In .NET Framework ist das Lesen der -Eigenschaft zuverlässig, aber das Festlegen für einen anderen Thread als den aktuellen Thread ist dies nicht. In .NET Core wird eine ausgelöst, wenn ein Thread versucht, die Eigenschaft in einem anderen Thread zu lesen InvalidOperationException CurrentCulture oder zu schreiben. Es wird empfohlen, die -Eigenschaft CultureInfo.CurrentCulture zum Abrufen und Festlegen der aktuellen Kultur zu verwenden.

Ab dem .NET Framework 4 können Sie die -Eigenschaft CurrentCulture auf eine neutrale Kultur festlegen. Dies liegt daran, dass sich das Verhalten der -Klasse geändert hat: Wenn sie eine neutrale Kultur darstellt, spiegeln ihre Eigenschaftswerte (insbesondere die Eigenschaften , , , und ) jetzt die spezifische Kultur wider, die der neutralen Kultur CultureInfo Calendar zugeordnet CompareInfo DateTimeFormat NumberFormat TextInfo ist. In früheren Versionen des .NET Framework hat die CurrentCulture -Eigenschaft eine Ausnahme ausgelöst, NotSupportedException wenn eine neutrale Kultur zugewiesen wurde.