Share via


Why is STAThread required?

Over the top of your Main method, you may have noticed this funny decoration:

[STAThread]`` static void Main() {

Several people have asked, what is this and is it this actually necessary? 

When the STAThreadAttribute is applied, it changes the apartment state of the current thread to be single threaded. Without getting into a huge discussion about COM and threading, this attribute ensures the communication mechanism between the current thread and other threads that may want to talk to it via COM. When you're using Windows Forms, depending on the feature you're using, it may be using COM interop in order to communicate with operating system components. Good examples of this are the Clipboard and the File Dialogs. 

Windows Forms is not supported within a MTA or free threaded apartment. Applications using Windows Forms should always declare the apartment style they're using, as some other component could initialize the apartment state of thread improperly. 

If the application cannot control the apartment state of the current thread, it should start up a new thread. Here's a quick example:

using System.Threading; `` Thread t = new Thread(new ThreadStart(StartNewStaThread)); // Make sure to set the apartment state BEFORE starting the thread. t.ApartmentState = ApartmentState.STA; t.Start(); `` private void StartNewStaThread() {     Application.Run(new Form1()); }

Related Documentation:

INFO: Calling Shell Functions and Interfaces from a Multithreaded Apartment

Shell does not support MTA

Choosing the Threading Model

[Post 2.0 release update]
Instead of using t.ApartmentState, use t.SetApartmentState(ApartmentState.STA);

If you dont want to fuss with setting it manually, you can also put the [STAThread] attribute on top of StartNewStaThread method:

Thread t = new Thread(new ThreadStart(StartNewStaThread));
t.Start();

[STAThread]
private void StartNewStaThread() {
Application.Run(new Form1());
}

Comments