STAThreadAttribute Classe

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

ThreadAttributes.cs

Indique que le modèle de thread COM pour une application est un appartement à thread unique (STA).

public ref class STAThreadAttribute sealed : Attribute

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

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

Public NotInheritable Class STAThreadAttribute
Inherits Attribute

Héritage

Object

Attribute

STAThreadAttribute

Attributs

AttributeUsageAttribute

Remarques

Appliquez cet attribut à la méthode de point d’entrée (la méthode Main() en C# et Visual Basic). Elle n’a aucun effet sur d’autres méthodes. Pour définir l’état d’appartement des threads que vous démarrez dans votre code, utilisez la ou Thread.TrySetApartmentState la Thread.SetApartmentState méthode avant de démarrer le thread.

Les modèles de thread COM s’appliquent uniquement aux applications qui utilisent l’interopérabilité COM. Le modèle de thread COM peut être défini sur un appartement monothread ou un appartement multithread. Le thread d’application est initialisé uniquement pour l’interopérabilité COM si le thread effectue réellement un appel à un composant COM. Si l’interopérabilité COM n’est pas utilisée, le thread n’est pas initialisé et l’attribut STAThreadAttribute , s’il est présent, n’a aucun effet.

À compter de .NET Framework version 2.0, le modèle de thread par défaut pour l’interopérabilité COM dépend du langage dans lequel vous développez votre application, comme le montre le tableau suivant.

Language	Modèle d’appartement COM
C#	Appartement multithread
C++	Appartement multithread
Visual Basic	Appartement à thread unique

Pour modifier ces valeurs par défaut, vous utilisez l’attribut STAThreadAttribute pour définir le modèle de thread pour l’application, ou appelez la ou Thread.TrySetApartmentState la Thread.SetApartmentState méthode avant de démarrer le thread pour définir le modèle de thread pour un thread particulier. En C++, vous pouvez également utiliser l’option /CLRTHTHREADATTRIBUTE linker pour spécifier le modèle d’appartement.

ASP.NET applications doivent définir l’attribut ASPCompat de la directive @ Page sur true pour forcer le service de la page par le pool de threads STA.

Voici quelques-uns des cas dans lesquels vous souhaitez utiliser l’attribut STAThreadAttribute pour définir explicitement le modèle de thread sur l’appartement monothread :

• Vous développez une application Windows Forms. Windows Forms applications doivent être monothread si elles communiquent avec Windows composants système tels que le Presse-papiers ou Windows boîtes de dialogue courantes, ou s’ils utilisent des fonctionnalités système telles que les fonctionnalités glisser-déplacer. Le modèle d’application Windows Forms pour C# ajoute automatiquement l’attribut STAThreadAttribute aux projets C#. Étant donné que le modèle d’appartement à thread unique est la valeur par défaut pour Visual Basic, il n’est pas nécessaire pour l’attribut.

• Vous développez une application C# qui appelle une bibliothèque Visual Basic, qui, à son tour, s'appuie sur l'interopérabilité COM. Étant donné que le modèle d'appartement à thread unique est la valeur par défaut pour Visual Basic, vous devez remplacer le modèle de thread de votre application par thread unique à l'aide de l'attribut STAThreadAttribute.

• Votre application effectue des appels aux composants COM qui utilisent le modèle d’appartement monothread.

Constructeurs

Nom	Description
STAThreadAttribute()	Initialise une nouvelle instance de la classe STAThreadAttribute.

Propriétés

Nom	Description
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage pour cette instance. (Hérité de Attribute)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• MTAThreadAttribute