/CLRTHREADATTRIBUTE (Définir l'attribut de thread CLR)

  • Article

Spécifiez explicitement l’attribut de thread pour le point d’entrée de votre programme CLR.

Syntaxe

/CLRTHREADATTRIBUTE:{STA|MTA|NONE}

Paramètres

MTA
Applique l’attribut MTAThreadAttribute au point d’entrée de votre programme.

NONE
Identique à ne pas spécifier /CLRTHTHREADATTRIBUTE. Permet au Common Language Runtime (CLR) de définir l’attribut de thread par défaut.

STA
Applique l’attribut STAThreadAttribute au point d’entrée de votre programme.

Notes

La définition de l’attribut de thread est valide uniquement lors de la génération d’un fichier .exe, car il affecte le point d’entrée du thread principal.

Si vous utilisez le point d’entrée par défaut (principal ou wmain, par exemple) spécifiez le modèle de thread à l’aide de /CLRTHREADATTRIBUTE ou en plaçant l’attribut de threading (STAThreadAttribute ou MTAThreadAttribute) sur la fonction d’entrée par défaut.

Si vous utilisez un point d’entrée non par défaut, spécifiez le modèle de thread à l’aide de /CLRTHREADATTRIBUTE ou en plaçant l’attribut threading sur la fonction d’entrée non par défaut, puis spécifiez le point d’entrée non par défaut avec /ENTRY.

Si le modèle de thread spécifié dans le code source n’est pas d’accord avec le modèle de thread spécifié avec /CLRTHREADATTRIBUTE, l’éditeur de liens ignore /CLRTHREADATTRIBUTE et applique le modèle de thread spécifié dans le code source.

Il sera nécessaire d’utiliser le thread unique, par exemple, si votre programme CLR héberge un objet COM qui utilise un thread unique. Si votre programme CLR utilise le multithreading, il ne peut pas héberger un objet COM qui utilise un thread unique.

Pour définir cette option de l'éditeur de liens dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés Avancées de l’Éditeur >de propriétés>de configuration.

  3. Modifiez la propriété Attribut de thread CLR.

Pour définir cette option de l'éditeur de liens par programmation

  1. Consultez CLRThreadAttribute.

Voir aussi

Informations de référence sur l’éditeur de liens MSVC
Options de l’éditeur de liens MSVC