CultureInfo.CurrentUICulture-Eigenschaft (System.Globalization)

.NET Framework-Klassenbibliothek

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)

Syntax

Visual Basic (Deklaration)

Public Shared ReadOnly Property CurrentUICulture As CultureInfo

Visual Basic (Verwendung)

Dim value As CultureInfo

value = CultureInfo.CurrentUICulture

public static CultureInfo CurrentUICulture { get; }

VisualC++

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

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

Jscript

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.

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, 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.

Beispiele

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

Visual Basic

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.

*/

VisualC++

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 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.

Versionsinformationen