STAThreadAttribute 类

定义

public ref class STAThreadAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class STAThreadAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class STAThreadAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type STAThreadAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type STAThreadAttribute = class
    inherit Attribute

Public NotInheritable Class STAThreadAttribute
Inherits Attribute

继承

Object

Attribute

STAThreadAttribute

属性

AttributeUsageAttribute ComVisibleAttribute

注解

将此属性应用于入口点方法（C# 和 Visual Basic 中的 Main() 方法）。 它对其他方法没有影响。 若要设置在代码中启动的线程的单元状态，请在启动线程之前使用 Thread.SetApartmentState 或 Thread.TrySetApartmentState 方法。

COM 线程模型仅适用于使用 COM 互操作的应用程序。 COM 线程模型可以设置为单线程单元或多线程单元。 如果线程实际调用 COM 组件，则仅针对 COM 互操作初始化应用程序线程。 如果未使用 COM 互操作，则不会初始化线程，并且 STAThreadAttribute 属性（如果存在）不起作用。

从 .NET Framework 版本 2.0 开始，COM 互操作的默认线程模型取决于正在开发应用程序的语言，如下表所示。

若要更改这些默认值，请使用 STAThreadAttribute 属性为应用程序设置线程模型，或者在启动线程之前调用 Thread.SetApartmentState 或 Thread.TrySetApartmentState 方法来设置特定线程的线程模型。 在 C++ 中，还可以使用 /CLRTHREADATTRIBUTE 链接器选项指定单元模型。

ASP.NET 应用程序应将 @ Page 指令的 ASPCompat 属性设置为 true，以强制由 STA 线程池为页面提供服务。

下面是一些需要使用属性将线程模型显式设置为单线程单元的情况 STAThreadAttribute ：

• 你正在开发Windows 窗体应用。 Windows 窗体 如果应用与Windows系统组件（如剪贴板或Windows常见对话框）通信，或者应用使用拖放功能等系统功能，则必须使用单线程应用。 适用于 C# 的 Windows 窗体 应用程序模板会自动将 STAThreadAttribute 属性添加到 C# 项目。 由于单线程单元模型是Visual Basic的默认模型，因此不需要该属性。

• 你正在开发一个调用Visual Basic库的 C# 应用，而该库又依赖于 COM 互操作。 由于单线程单元模型是Visual Basic的默认模型，因此应使用 STAThreadAttribute 属性将应用的线程模型更改为单线程模型。

• 应用程序调用使用单线程单元模型的 COM 组件。

另请参阅

• MTAThreadAttribute