component pragma

Steuert die Sammlung von Suchinformationen oder Abhängigkeitsinformationen aus Quelldateien.

Syntax

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

Hinweise

Browser

Sie können das Sammeln aktivieren oder deaktivieren, und Sie können angeben, dass bestimmte Namen beim Sammeln von Informationen ignoriert werden.

Die Verwendung von Ein- oder Aus-Steuerelementen steuert die Sammlung von Suchinformationen aus der pragma Zukunft. Beispiel:

#pragma component(browser, off)

Dieser Code stoppt das Sammeln von Browserinformationen durch den Compiler.

Hinweis

Um die Erfassung von Suchinformationen mit dieser pragmaOption zu aktivieren, müssen Die Suchinformationen zuerst aktiviert sein.

Die references Option kann mit oder ohne das Namensargument verwendet werden. Die Verwendung references ohne Namen aktiviert oder deaktiviert das Sammeln von Verweisen (andere Browseinformationen werden jedoch weiterhin gesammelt). Beispiel:

#pragma component(browser, off, references)

Dieser Code stoppt das Sammeln von Verweisinformationen durch den Compiler.

Die Verwendung references mit Dem Namen verhindert off , dass Verweise auf Namen im Fenster zum Durchsuchen von Informationen angezeigt werden. Verwenden Sie die folgende Syntax, um Namen und Typen zu ignorieren, die für Sie nicht relevant sind, und die Größe von Browserinformationsdateien zu reduzieren. Beispiel:

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

ignoriert Verweise auf DWORD von diesem Punkt nach vorne. Sie können das Sammeln von Verweisen auf DWORD wieder aktivieren, indem Sie Folgendes verwenden on:

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

Dies ist die einzige Möglichkeit, das Sammeln von Verweisen auf den Namen fortzusetzen. Sie müssen explizit alle Namen aktivieren, die Sie deaktiviert haben.

Um zu verhindern, dass der Präprozessor den Namen erweitert (z. B. NULL auf 0 erweitern), setzen Sie Anführungszeichen um:

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

Minimale Neuerstellung

Das veraltete /Gm Feature (Minimale Neuerstellung aktivieren) erfordert, dass der Compiler Abhängigkeitsinformationen der C++-Klasse erstellt und speichert, was Speicherplatz benötigt. Um Speicherplatz zu sparen, können Sie immer dann verwenden #pragma component( minrebuild, off ) , wenn Sie keine Abhängigkeitsinformationen sammeln müssen, z. B. in nicht veränderten Headerdateien. Fügen Sie #pragma component( minrebuild, on ) nach unveränderbaren Klassen ein, um die Abhängigkeitsauflistung wieder zu aktivieren.

Reduzieren von Typinformationen

Die mintypeinfo Option reduziert die Debuginformationen für die angegebene Region. Diese Informationen haben einen beträchtlichen Umfang und wirken sich auf PDB- und OBJ-Dateien aus. Sie können Klassen und Strukturen in der mintypeinfo Region nicht debuggen. Die Verwendung der mintypeinfo Option kann hilfreich sein, um die folgende Warnung zu vermeiden:

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

Weitere Informationen finden Sie unter der /Gm Compileroption (Minimale Neuerstellung aktivieren).

Siehe auch

Pragma-Direktiven und die __pragma und _Pragma Schlüsselwort (keyword)