STAThreadAttribute Classe

Definição

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

Herança

Object

Attribute

STAThreadAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Observações

Aplique este atributo ao método do ponto de entrada (o método Main() em C# e Visual Basic). Não tem efeito noutros métodos. Para definir o estado de apartamento dos threads que começas no teu código, usa o Thread.SetApartmentState método ou Thread.TrySetApartmentState antes de iniciar o thread.

Os modelos de threading COM aplicam-se apenas a aplicações que utilizam interoperabilidade COM. O modelo de threading COM pode ser definido como apartamento single-threaded ou multithreaded. O thread de aplicação só é inicializado para interoperabilidade COM se o thread efetuar efetivamente uma chamada a um componente COM. Se a interoperabilidade COM não for utilizada, então a thread não é inicializada, e o STAThreadAttribute atributo, se estiver presente, não tem efeito.

A partir da versão 2.0 do .NET Framework, o modelo de threading padrão para interoperabilidade COM depende da linguagem em que está a desenvolver a sua aplicação, como mostra a tabela seguinte.

Para alterar estes predefinidos, usa o STAThreadAttribute atributo para definir o modelo de threading da aplicação, ou chama o Thread.SetApartmentState método or Thread.TrySetApartmentState antes de iniciar a thread para definir o modelo de threading para uma thread específica. Em C++, também pode usar a opção linker /CLRTHREAD para especificar o modelo do apartamento.

ASP.NET aplicações devem definir o atributo ASPCompat da diretiva @ Page como true para forçar a página a ser servida pelo pool de threads STA.

Aqui estão alguns dos casos em que vais querer usar o STAThreadAttribute atributo para definir explicitamente o modelo de threading como single-threaded apartment:

• Estás a desenvolver uma aplicação Windows Forms. As aplicações do Windows Forms devem ser single-threaded se comunicarem com componentes do sistema Windows, como as caixas de diálogo comuns do Clipboard ou do Windows, ou se usarem funcionalidades do sistema como arrastar e largar. O modelo Windows Forms Application para C# adiciona automaticamente o atributo STAThreadAttribute aos projetos C#. Como o modelo de apartamento single-threaded é o padrão do Visual Basic, não há necessidade do atributo.

• Estás a desenvolver uma aplicação C# que chama uma biblioteca Visual Basic, que, por sua vez, depende da interoperabilidade COM. Como o modelo de apartamento single-threaded é o padrão para Visual Basic, deves mudar o modelo de threading da tua app para single-threaded usando o atributo STAThreadAttribute.

• A sua aplicação faz chamadas para componentes COM que utilizam o modelo de apartamento single-threaded.

Ver também

• MTAThreadAttribute