MTAThreadAttribute Classe

Definição

public ref class MTAThreadAttribute sealed : Attribute

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

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

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

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

Public NotInheritable Class MTAThreadAttribute
Inherits Attribute

Herança

Object

Attribute

MTAThreadAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Comentários

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

Os modelos de threading COM se aplicam somente a aplicativos que usam a interoperabilidade COM. O modelo de threading COM pode ser definido como apartamento com thread único ou apartamento multithread. 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 MTAThreadAttribute atributo, se ele estiver presente, não terá efeito.

O modelo de threading padrão para interoperabilidade COM depende do idioma no qual você está desenvolvendo seu aplicativo, como mostra a tabela a seguir.

Para alterar esses padrões, use o MTAThreadAttribute 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 (Definir Atributo de Thread CLR) para especificar o modelo de apartamento.

Use o MTAThreadAttribute atributo para definir explicitamente o modelo de threading como um apartamento multithreaded nos seguintes casos:

• Você está desenvolvendo um aplicativo Visual Basic que chama uma biblioteca C# que, por sua vez, depende da interoperabilidade COM. Como o modelo de apartamento multithreaded é o padrão para C#, você deve alterar o modelo de threading do aplicativo para multithread usando o MTAThreadAttribute atributo.
• Seu aplicativo faz chamadas para componentes COM que usam o modelo de apartamento multithreaded.

Confira também

• STAThreadAttribute