Auf Englisch lesen

Freigeben über


Thread.CurrentUICulture Eigenschaft

Definition

Ruft die aktuelle Kultur ab, mit deren Hilfe der Ressourcen-Manager zur Laufzeit kulturabhängige Ressourcen sucht, oder legt diese fest.

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

Eigenschaftswert

Ein Objekt, das die aktuelle Kultur darstellt.

Ausnahmen

Die Eigenschaft ist auf null festgelegt.

Die Eigenschaft ist auf einen Kulturnamen festgelegt, der nicht zum Suchen einer Ressourcendatei verwendet werden kann. Ressourcendateinamen dürfen nur Buchstaben, Zahlen, Bindestriche oder Unterstriche enthalten.

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

Beispiele

Im folgenden Beispiel wird bestimmt, ob die Sprache der Benutzeroberflächenkultur des aktuellen Threads Französisch ist. Andernfalls wird die Ui-Kultur des aktuellen Threads auf Englisch (USA) festgelegt.

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]

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

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());
    }
}

Hinweise

Die Benutzeroberflächenkultur gibt die Ressourcen an, die eine Anwendung zur Unterstützung von Benutzereingaben und -ausgaben benötigt, und ist standardmäßig mit der Betriebssystemkultur identisch. In der CultureInfo Klasse erfahren Sie mehr über Kulturnamen und Bezeichner, die Unterschiede zwischen invariante, neutrale und bestimmte Kulturen und die Art und Weise, wie Kulturinformationen Sich auf Threads und Anwendungsdomänen auswirken. In der CultureInfo.CurrentUICulture -Eigenschaft erfahren Sie, wie die Standardkultur der Benutzeroberfläche eines Threads bestimmt wird.

Wichtig

Die CurrentUICulture 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, das Festlegen für einen anderen Thread als den aktuellen Thread ist es jedoch nicht. In .NET Core wird ein InvalidOperationException ausgelöst, wenn ein Thread versucht, die CurrentUICulture Eigenschaft in einem anderen Thread zu lesen oder zu schreiben. Es wird empfohlen, die CultureInfo.CurrentUICulture -Eigenschaft zum Abrufen und Festlegen der aktuellen Kultur zu verwenden.

Die CultureInfo von dieser Eigenschaft zurückgegebene kann eine neutrale Kultur sein. Neutrale Kulturen sollten nicht mit Formatierungsmethoden wie String.Format(IFormatProvider, String, Object[]), DateTime.ToString(String, IFormatProvider)und Convert.ToString(Char, IFormatProvider)verwendet werden. Verwenden Sie die CultureInfo.CreateSpecificCulture -Methode, um eine bestimmte Kultur abzurufen, oder verwenden Sie die CurrentCulture -Eigenschaft.

Gilt für:

Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1