Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

CultureInfo.CurrentUICulture-Eigenschaft

Aktualisiert: November 2007

Ruft die CultureInfo ab, die die aktuelle Kultur darstellt, mit deren Hilfe der Ressourcen-Manager kulturabhängige Ressourcen zur Laufzeit sucht.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

public static CultureInfo CurrentUICulture { get; }
/** @property */
public static CultureInfo get_CurrentUICulture()

public static function get CurrentUICulture () : CultureInfo

Eigenschaftenwert

Typ: System.Globalization.CultureInfo
Die CultureInfo, die die aktuelle Kultur darstellt, mit deren Hilfe der Ressourcen-Manager kulturabhängige Ressourcen zur Laufzeit sucht.

Die Kultur ist eine Eigenschaft des gerade ausgeführten Threads. Diese Eigenschaft gibt Thread.CurrentUICulture zurück. Beim Starten eines Threads wird die Kultur für seine Benutzeroberfläche am Anfang mithilfe von GetUserDefaultUILanguage aus der Windows-API bestimmt. Wenn die von einem Thread verwendete Benutzeroberflächenkultur geändert werden soll, muss Thread.CurrentUICulture in der Anwendung auf die neue Kultur festgelegt werden. Das Ändern der Kultur von Thread.CurrentThread erfordert eine SecurityPermission, bei der der ControlThread-Wert festgelegt ist. Aufgrund des mit Threads verbundenen Sicherheitszustands stellt eine Änderung von Threads ein Risiko dar. Aus diesem Grund sollte diese Berechtigung ausschließlich vertrauenswürdigem Code erteilt werden, wenn dies tatsächlich erforderlich ist. In teilweise vertrauenswürdigem Code kann die Kultur eines Threads von einer Anwendung nicht geändert werden.

Im folgenden Codebeispiel wird das Ändern von CurrentCulture und CurrentUICulture des aktuellen Threads veranschaulicht.

using System;
using System.Globalization;
using System.Security.Permissions;
using System.Threading;

[assembly:SecurityPermission( SecurityAction.RequestMinimum, ControlThread = true )]
public class SamplesCultureInfo  {

   public static void Main()  {

      // Displays the name of the CurrentCulture of the current thread.
      Console.WriteLine( "CurrentCulture is {0}.", CultureInfo.CurrentCulture.Name );

      // Changes the CurrentCulture of the current thread to th-TH.
      Thread.CurrentThread.CurrentCulture = new CultureInfo( "th-TH", false );
      Console.WriteLine( "CurrentCulture is now {0}.", CultureInfo.CurrentCulture.Name );

      // Displays the name of the CurrentUICulture of the current thread.
      Console.WriteLine( "CurrentUICulture is {0}.", CultureInfo.CurrentUICulture.Name );

      // Changes the CurrentUICulture of the current thread to ja-JP.
      Thread.CurrentThread.CurrentUICulture = new CultureInfo( "ja-JP", false );
      Console.WriteLine( "CurrentUICulture is now {0}.", CultureInfo.CurrentUICulture.Name );

   }

}

/*
This code produces the following output, if the ControlThread permission is granted (for example, if this code is run from the local drive).

CurrentCulture is en-US.
CurrentCulture is now th-TH.
CurrentUICulture is en-US.
CurrentUICulture is now ja-JP.

*/


import System.* ;
import System.Globalization.* ;
import System.Security.Permissions.* ;
import System.Threading.* ;

/** @assembly SecurityPermission(SecurityAction.RequestMinimum, 
        ControlThread = true)
 */
public class SamplesCultureInfo
{
       public static void main(String[] args)
    {
        // Displays the name of the CurrentCulture of the current thread.
        Console.WriteLine("CurrentCulture is {0}.", 
            CultureInfo.get_CurrentCulture().get_Name());

        // Changes the CurrentCulture of the current thread to th-TH.
        System.Threading.Thread.get_CurrentThread().set_CurrentCulture( 
            new CultureInfo("th-TH", false));
        Console.WriteLine("CurrentCulture is now {0}.", 
            CultureInfo.get_CurrentCulture().get_Name());

        // Displays the name of the CurrentUICulture of the current thread.
        Console.WriteLine("CurrentUICulture is {0}.", 
            CultureInfo.get_CurrentUICulture().get_Name());

        // Changes the CurrentUICulture of the current thread to ja-JP.
        System.Threading.Thread.get_CurrentThread().set_CurrentUICulture( 
            new CultureInfo("ja-JP", false));
        Console.WriteLine("CurrentUICulture is now {0}.", 
            CultureInfo.get_CurrentUICulture().get_Name());
    } //main 
} //SamplesCultureInfo

/*
This code produces the following output, if the ControlThread permission is 
granted (for example, if this code is run from the local drive).

CurrentCulture is en-US.
CurrentCulture is now th-TH.
CurrentUICulture is en-US.
CurrentUICulture is now ja-JP.
*/


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC, Xbox 360

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0, 1.0

XNA Framework

Unterstützt in: 2.0, 1.0
Anzeigen: