MTAThreadAttribute-Klasse
Legt MTA (Multithreaded Apartment) als COM-Threadingmodell für Anwendungen fest.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<AttributeUsageAttribute(AttributeTargets.Method)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class MTAThreadAttribute
Inherits Attribute
'Usage
Dim instance As MTAThreadAttribute
[AttributeUsageAttribute(AttributeTargets.Method)]
[ComVisibleAttribute(true)]
public sealed class MTAThreadAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Method)]
[ComVisibleAttribute(true)]
public ref class MTAThreadAttribute sealed : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Method) */
/** @attribute ComVisibleAttribute(true) */
public final class MTAThreadAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Method)
ComVisibleAttribute(true)
public final class MTAThreadAttribute extends Attribute
Hinweise
Übernehmen Sie dieses Attribut für die Einstiegspunktmethode (die Main()-Methode in C# und Visual Basic). Es hat keine Auswirkungen auf andere Methoden. Zum Festlegen des Apartmentzustands von Threads starten Sie den Code und verwenden die Thread.SetApartmentState-Methode vor dem Start des Threads.
Hinweis
Legen Sie in .NET Framework, Version 1.0 und 1.1, vor dem Starten des Threads die Thread.ApartmentState-Eigenschaft fest.
COM-Threadingmodelle betreffen nur Anwendungen, die COM-Interop verwenden. Das Verwenden dieses Attributs in einer Anwendung, die COM-Interop nicht verwendet, hat keine Auswirkungen.
Das COM-Threadingmodell kann auf Singlethreaded Apartment oder Multithreaded Apartment festgelegt werden. Der Anwendungsthread wird nur für COM-Interop initialisiert, wenn der Thread tatsächlich eine COM-Komponente aufruft. Wenn COM-Interop nicht verwendet wird, wird auch der Thread nicht initialisiert.
Verwenden Sie dieses Attribut in .NET Framework, Version 1.0 und 1.1, für Main(), anstatt die Thread.ApartmentState-Eigenschaft in der ersten Codezeile festzulegen, um sicherzustellen, dass das Threadingmodell vor dem Ausführen von Startcode festgelegt wird.
Wichtig
In .NET Framework, Version 2.0, werden neue Threads als ApartmentState.MTA initialisiert, wenn ihr Apartmentzustand vor ihrem Start nicht festgelegt wurde. Der Hauptanwendungsthread wird standardmäßig mit ApartmentState.MTA initialisiert. Sie können den Hauptanwendungsthread nicht mehr auf ApartmentState.STA festlegen, indem Sie die Thread.ApartmentState-Eigenschaft in der ersten Codezeile festlegen. Verwenden Sie stattdessen STAThreadAttribute.
In .NET Framework, Version 2.0, können Sie das COM-Threadingmodell für eine C++-Anwendung auch mit der Linkeroption /CLRTHREADATTRIBUTE (Festlegen des CLR-Threadattributs) angeben.
Bei ASP.NET-Anwendungen sollte das ASPCompat-Attribut der @ Page-Direktive auf true festgelegt werden, damit die Seite durch den STA-Threadpool unterstützt wird.
Vererbungshierarchie
System.Object
System.Attribute
System.MTAThreadAttribute
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
MTAThreadAttribute-Member
System-Namespace
STAThreadAttribute