Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

CultureInfo.CurrentUICulture Property

Gets the CultureInfo that represents the current culture used by the Resource Manager to look up culture-specific resources at run time.

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

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

public static function get CurrentUICulture () : CultureInfo

Property Value

The CultureInfo that represents the current culture used by the Resource Manager to look up culture-specific resources at run time.

The culture is a property of the executing thread. This property returns Thread.CurrentUICulture. When a thread is started, its UI culture is initially determined by using GetUserDefaultUILanguage from the Windows API. To change the UI culture used by a thread, set Thread.CurrentUICulture to the new culture. Changing the culture of Thread.CurrentThread requires a SecurityPermission with the ControlThread flag set. Manipulating threads is dangerous because of the security state associated with threads. Therefore, this permission should be given only to trustworthy code, and then only as necessary. You cannot change a thread's culture in semi-trusted code.

The following code example demonstrates how to change the CurrentCulture and CurrentUICulture of the current thread.

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

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.