STAThreadAttribute Klasse

Definition

Gibt an, dass STA (Singlethreaded Apartment) als COM-Threadingmodell für eine Anwendung verwendet wird.

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
Vererbung
STAThreadAttribute
Attribute

Hinweise

Wenden Sie dieses Attribut auf die Einstiegspunktmethode (die Main() Methode in C# und Visual Basic) an. Es hat keine Auswirkungen auf andere Methoden. Um den Apartmentstatus der Threads festzulegen, die Sie in Ihrem Code starten, verwenden Sie die Thread.SetApartmentState - oder Thread.TrySetApartmentState -Methode, bevor Sie den Thread starten.

Hinweis

Eine Übersicht über COM-Threadingmodelle finden Sie unter Grundlegendes und Verwenden von COM-Threadingmodellen.

COM-Threadingmodelle gelten nur für Anwendungen, die COM-Interop verwenden. Das COM-Threadingmodell kann auf Singlethread-Apartment oder Multithread-Apartment festgelegt werden. Der Anwendungsthread wird nur für COM-Interop initialisiert, wenn der Thread tatsächlich eine COM-Komponente aufruft. Wenn keine COM-Interop verwendet wird, wird der Thread nicht initialisiert, und das STAThreadAttribute Attribut hat, sofern vorhanden, keine Auswirkung.

Ab der .NET Framework Version 2.0 hängt das Standardthreadingmodell für COM-Interop von der Sprache ab, in der Sie Ihre Anwendung entwickeln, wie in der folgenden Tabelle gezeigt.

Sprache COM-Apartmentmodell
C# Multithread-Wohnung
C++ Multithread-Wohnung
Visual Basic Singlethread-Apartment

Um diese Standardwerte zu ändern, verwenden Sie das STAThreadAttribute -Attribut, um das Threadingmodell für die Anwendung festzulegen, oder rufen die Thread.SetApartmentState - oder Thread.TrySetApartmentState -Methode auf, bevor Sie den Thread starten, um das Threadingmodell für einen bestimmten Thread festzulegen. In C++ können Sie auch die Linkeroption /CLRTHREADATTRIBUTE verwenden, um das Apartmentmodell anzugeben.

ASP.NET Anwendungen sollten das ASPCompat Attribut der @ Page-Direktive auf true festlegen, um zu erzwingen, dass die Seite vom STA-Threadpool bedient wird.

Im Folgenden finden Sie einige Fälle, in denen Sie das STAThreadAttribute -Attribut verwenden möchten, um das Threadingmodell explizit auf Singlethread-Apartment festzulegen:

  • Sie entwickeln eine Windows Forms-App. Windows Forms Apps müssen Singlethreads sein, wenn sie mit Windows-Systemkomponenten wie der Zwischenablage oder allgemeinen Windows-Dialogfeldern kommunizieren oder Systemfeatures wie Drag-and-Drop-Funktionen verwenden. Die Windows Forms-Anwendungsvorlage für C# fügt das STAThreadAttribute Attribut automatisch zu C#-Projekten hinzu. Da das Singlethread-Apartmentmodell die Standardeinstellung für Visual Basic ist, ist das Attribut nicht erforderlich.

  • Sie entwickeln eine C#-App, die eine Visual Basic-Bibliothek aufruft, die wiederum auf COM-Interop basiert. Da das Singlethread-Apartmentmodell die Standardeinstellung für Visual Basic ist, sollten Sie das Threadingmodell Ihrer App mithilfe des STAThreadAttribute -Attributs in Singlethreads ändern.

  • Ihre Anwendung führt Aufrufe von COM-Komponenten durch, die das Singlethread-Apartmentmodell verwenden.

Konstruktoren

STAThreadAttribute()

Initialisiert eine neue Instanz der STAThreadAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.

(Geerbt von Attribute)

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen