System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the culture for the current thread.

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

public CultureInfo CurrentCulture {
	get;
	[SecurityPermissionAttribute(SecurityAction.Demand, ControlThread = true)]
	set;
}
public:
property CultureInfo^ CurrentCulture {
	CultureInfo^ get();
	[SecurityPermissionAttribute(SecurityAction::Demand, ControlThread = true)]
	void set(CultureInfo^ value);
}
member CurrentCulture : CultureInfo with get, set
Public Property CurrentCulture As CultureInfo

Property Value

Type:

An object that represents the culture for the current thread.

Exception Condition
ArgumentNullException

The property is set to null.

The CultureInfo object that is returned by this property, together with its associated objects, determine the default format for dates, times, numbers, currency values, the sorting order of text, casing conventions, and string comparisons. See the CultureInfo class to learn about culture names and identifiers, the differences between invariant, neutral, and specific cultures, and the way culture information affects threads and application domains. See the property to learn how a thread's default culture is determined, and how users set culture information for their computers.

Beginning with the .NET Framework 4, you can set the property to a neutral culture. This is because the behavior of the CultureInfo class has changed: When it represents a neutral culture, its property values (in particular, the , , , , and properties) now reflect the specific culture that is associated with the neutral culture. In earlier versions of the .NET Framework, the property threw a NotSupportedException exception when a neutral culture was assigned.

The following code example shows the threading statement that allows the user interface of a Windows Forms to display in the culture that is set in Control Panel. Additional code is needed.

using System;
using System.Threading;
using System.Windows.Forms;

class UICulture : Form
{
    public UICulture()
    {
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = 
            Thread.CurrentThread.CurrentCulture;

        // Add additional code.
    }

    static void Main()
    {
        Application.Run(new UICulture());
    }
}
Imports System.Threading
Imports System.Windows.Forms

Public Class UICulture : Inherits Form
    Sub New()

        ' Set the user interface to display in the
        ' same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = _
            Thread.CurrentThread.CurrentCulture

        ' Add additional code.
    End Sub

    Shared Sub Main()
        Application.Run(New UICulture())
    End Sub
End Class
#using <system.dll>
#using <System.Drawing.dll>
#using <system.windows.forms.dll>

using namespace System;
using namespace System::Threading;
using namespace System::Windows::Forms;
ref class UICulture: public Form
{
public:
   UICulture()
   {

      // Set the user interface to display in the
      // same culture as that set in Control Panel.
      Thread::CurrentThread->CurrentUICulture = Thread::CurrentThread->CurrentCulture;

      // Add additional code.
   }
};


int main()
{
   Application::Run( gcnew UICulture );
}
SecurityPermission

for setting the property. Associated enumeration: SecurityPermissionFlagControlThread

.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top