CultureInfo.CurrentUICulture-Eigenschaft

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)

Syntax

'Declaration
Public Shared ReadOnly Property CurrentUICulture As CultureInfo
'Usage
Dim value As CultureInfo

value = CultureInfo.CurrentUICulture

public static CultureInfo CurrentUICulture { get; }

public:
static property CultureInfo^ CurrentUICulture {
    CultureInfo^ get ();
}

/** @property */
public static CultureInfo get_CurrentUICulture ()

public static function get CurrentUICulture () : CultureInfo

Eigenschaftenwert

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

Hinweise

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, legen Sie Thread.CurrentUICulture auf die neue Kultur fest. Das Ändern der Kultur von Thread.CurrentThread erfordert eine SecurityPermission, bei der das ControlThread-Flag 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. Die Kultur eines Threads in teilweise vertrauenswürdigem Code kann nicht geändert werden.

Beispiel

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

Imports System
Imports System.Globalization
Imports System.Security.Permissions
Imports System.Threading

<assembly: SecurityPermission(SecurityAction.RequestMinimum, ControlThread := True)>
Public Class SamplesCultureInfo

   Public Shared Sub 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)

   End Sub 'Main 

End Class '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.

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.

*/

using namespace System;
using namespace System::Globalization;
using namespace System::Security::Permissions;
using namespace System::Threading;

[assembly:SecurityPermission(SecurityAction::RequestMinimum,ControlThread=true)];
int 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 = gcnew 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::CurrentCulture->Name );
   
   // Changes the CurrentUICulture of the current thread to ja-JP.
   Thread::CurrentThread->CurrentUICulture = gcnew CultureInfo(  "ja-JP",false );
   Console::WriteLine(  "CurrentUICulture is now {0}.", CultureInfo::CurrentCulture->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.
*/

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

CultureInfo-Klasse
CultureInfo-Member
System.Globalization-Namespace
ResourceManager
Thread.CurrentUICulture
CultureInfo.CurrentCulture-Eigenschaft
InstalledUICulture
InvariantCulture
Parent
SecurityPermission
SecurityPermissionAttribute