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