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 in the upper-left corner of the page.