Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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.

[Visual Basic]
Public Shared ReadOnly Property CurrentUICulture As CultureInfo
[C#]
public static CultureInfo CurrentUICulture {get;}
[C++]
public: __property static CultureInfo* get_CurrentUICulture();
[JScript]
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.

Remarks

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.

Example

[Visual Basic, C#, C++] The following code example demonstrates how to change the CurrentCulture and CurrentUICulture of the current thread.

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


[C#] 
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.

*/

[C++] 
#using <mscorlib.dll>
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 = 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::CurrentCulture->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::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.

*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

CultureInfo Class | CultureInfo Members | System.Globalization Namespace | ResourceManager | Thread.CurrentUICulture | CurrentCulture | InstalledUICulture | InvariantCulture | Parent | SecurityPermission | SecurityPermissionAttribute

Show:
© 2014 Microsoft