component pragma

Contrôle la collection d’informations de navigation ou d’informations de dépendance à partir des fichiers sources.

Syntaxe

#pragma component( browser,{ onoff | } [ ,references [ ,nom ] ])
#pragma component( minrebuild, { on | off } )
#pragma component( mintypeinfo, { on | off } )

Notes

Browser

Vous pouvez désactiver ou activer la collecte, et spécifier des noms particuliers à ignorer lors de la collecte d'informations.

L’utilisation ou la désactivation des contrôles de la collection d’informations de navigation à partir de l’avant pragma . Par exemple :

#pragma component(browser, off)

arrête la collecte d'informations de consultation par le compilateur.

Remarque

Pour activer la collecte des informations de navigation avec ce pragmaparamètre, les informations de navigation doivent d’abord être activées.

L’option references peut être utilisée avec ou sans l’argument nom . L’utilisation references sans nom active ou désactive la collecte de références (d’autres informations de navigation continuent toutefois d’être collectées). Par exemple :

#pragma component(browser, off, references)

arrête la collecte d'informations de référence par le compilateur.

Utilisation references avec nom et off empêche l’affichage des références au nom dans la fenêtre Parcourir les informations. Utilisez cette syntaxe pour ignorer les noms et les types qui ne vous intéressent pas afin de réduire la taille des fichiers d'informations de consultation. Par exemple :

#pragma component(browser, off, references, DWORD)

ignore les références à DWORD à partir de ce point vers l’avant. Vous pouvez réactiver la collecte de références à DWORD à l’aide onde :

#pragma component(browser, on, references, DWORD)

Il s’agit de la seule façon de reprendre la collecte des références au nom ; vous devez activer explicitement tout nom que vous avez désactivé.

Pour empêcher le préprocesseur de développer le nom (par exemple, le développement de NULL à 0), placez les guillemets autour de celui-ci :

#pragma component(browser, off, references, "NULL")

Reconstruction minimale

La fonctionnalité déconseillée /Gm (Activer la reconstruction minimale) nécessite que le compilateur crée et stocke les informations de dépendance de classe C++, ce qui prend de l’espace disque. Pour économiser de l’espace disque, vous pouvez utiliser #pragma component( minrebuild, off ) chaque fois que vous n’avez pas besoin de collecter des informations de dépendance, par exemple, dans des fichiers d’en-tête immuables. Insérez #pragma component( minrebuild, on ) après des classes inchangées pour réactiver la collection de dépendances.

Réduire les informations de type

L’option mintypeinfo réduit les informations de débogage de la région spécifiée. Le volume de ces informations est considérable et a un impact sur les fichiers .pdb et .obj. Vous ne pouvez pas déboguer des classes et des structures dans la mintypeinfo région. L’utilisation de l’option mintypeinfo peut être utile pour éviter l’avertissement suivant :

LINK : warning LNK4018: too many type indexes in PDB "filename", discarding subsequent type information

Pour plus d’informations, consultez l’option (Activer la reconstruction minimale) du /Gm compilateur.

Voir aussi

Directives pragma et les __pragma_Pragma mot clé