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

Comentários

Aplique esse atributo ao método de ponto de entrada (o Main() método em C# e Visual Basic). Não tem efeito sobre outros métodos. Para definir o estado de apartment dos threads que você inicia em seu código, use o Thread.SetApartmentState método ou Thread.TrySetApartmentState antes de iniciar o thread.

Os modelos de threading COM só se aplicam a aplicativos que usam a interoperabilidade COM. O modelo de threading COM pode ser definido como apartment de thread único ou apartment multithreaded. O thread do aplicativo só será inicializado para interoperabilidade COM se o thread realmente fizer uma chamada para um componente COM. Se a interoperabilidade COM não for usada, o thread não será inicializado e o STAThreadAttribute atributo, se estiver presente, não terá efeito.

A partir do .NET Framework versão 2.0, o modelo de threading padrão para interoperabilidade COM depende da linguagem na qual você está desenvolvendo seu aplicativo, como mostra a tabela a seguir.

Para alterar esses padrões, use o STAThreadAttribute atributo para definir o modelo de threading para o aplicativo ou chame o Thread.SetApartmentState método ou Thread.TrySetApartmentState antes de iniciar o thread para definir o modelo de threading para um thread específico. No C++, você também pode usar a opção de vinculador /CLRTHREADATTRIBUTE para especificar o modelo apartment.

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

Aqui estão alguns dos casos em que você desejará usar o STAThreadAttribute atributo para definir explicitamente o modelo de threading como apartment de thread único:

• Você está desenvolvendo um aplicativo do Windows Forms. Os aplicativos do Windows Forms devem ser de thread único se se comunicarem com componentes do sistema Windows, como as caixas de diálogo comuns da Área de Transferência ou do Windows, ou se usarem recursos do sistema, como a funcionalidade de arrastar e soltar. O modelo de Aplicativo do Windows Forms para C# adiciona automaticamente o STAThreadAttribute atributo a projetos C#. Como o modelo de apartment de thread único é o padrão para o Visual Basic, não há necessidade do atributo.

• Você está desenvolvendo um aplicativo C# que chama uma biblioteca do Visual Basic que, por sua vez, depende da interoperabilidade COM. Como o modelo de apartment de thread único é o padrão para o Visual Basic, você deve alterar o modelo de threading do aplicativo para single-threaded usando o STAThreadAttribute atributo .

• Seu aplicativo faz chamadas para componentes COM que usam o modelo de apartment de thread único.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• MTAThreadAttribute