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

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 MTAThreadAttribute 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 MTAThreadAttribute 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 /CLRTHREADATTRIBUTE (Set CLR Thread Attribute) para especificar o modelo do apartamento.

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

• Estás a desenvolver uma aplicação Visual Basic que liga a uma biblioteca C# que, por sua vez, depende da interoperabilidade COM. Como o modelo multithreaded apartment é o padrão para C#, deve alterar o modelo de threading da sua aplicação para multithreaded usando o MTAThreadAttribute atributo.
• A sua aplicação faz chamadas para componentes COM que utilizam o modelo de apartamento multithreaded.

Ver também

• STAThreadAttribute