STAThreadAttribute Classe

Définition

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

Héritage

Object

Attribute

STAThreadAttribute

Attributs

AttributeUsageAttribute ComVisibleAttribute

Remarques

Appliquez cet attribut à la méthode du point d’entrée (la Main() méthode en C# et Visual Basic). Elle n’a aucun effet sur les autres méthodes. Pour définir l’état d’appartement des threads que vous démarrez dans votre code, utilisez la Thread.SetApartmentState méthode ou Thread.TrySetApartmentState 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 seul thread ou un appartement multithread. Le thread d’application est initialisé uniquement pour l’interopérabilité COM si le thread effectue un appel à un composant COM. Si COM Interop n’est pas utilisé, le thread n’est pas initialisé et l’attribut STAThreadAttribute , s’il est présent, n’a aucun effet.

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

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 Thread.SetApartmentState méthode ou Thread.TrySetApartmentState avant de démarrer le thread afin de définir le modèle de thread pour un thread particulier. En C++, vous pouvez également utiliser l’option de l’éditeur de liens /CLRTHREADATTRIBUTE 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 threading sur un seul thread :

• Vous développez une application Windows Forms. Les applications Windows Forms doivent être à thread unique si elles communiquent avec des composants système Windows tels que le Presse-papiers ou les boîtes de dialogue communes De Windows, ou si elles utilisent des fonctionnalités système telles que la fonctionnalité 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, l’attribut n’est pas nécessaire.

• 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 modifier le modèle de thread de votre application en monothread à l’aide de l’attribut STAThreadAttribute .

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

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• MTAThreadAttribute