Constantes de compilation conditionnelle

Mise à jour : novembre 2007

La compilation conditionnelle vous permet de contrôler facilement au moment de la compilation le code à inclure dans votre programme.

Le tableau suivant répertorie les constantes prédéfinies disponibles pour la compilation conditionnelle.

Constante

Description

CONFIG

Chaîne qui correspond au paramètre actuel de la zone Configuration de la solution active dans le Gestionnaire de configurations.

DEBUG

Valeur Boolean qui peut être définie dans la boîte de dialogue Propriétés du projet. Par défaut, la configuration de débogage pour un projet définit DEBUG. Lorsque DEBUG est défini, les méthodes de la classe Debug génèrent un résultat vers la fenêtre Sortie. Lorsque la constante n'est pas définie, les méthodes de classe Debug ne sont pas compilées et aucune sortie de débogage n'est générée.

TARGET

Chaîne représentant le type de sortie pour le projet ou le paramètre de l'option de ligne de commande /target. Les valeurs possibles de TARGET sont : "winexe" pour une application Windows, "exe" pour une application console, "library" pour une bibliothèque de classes et "module" pour un module. L'option /target peut être définie dans l'environnement de développement intégré Visual Studio. Pour plus d'informations, consultez /target.

TRACE

Valeur Boolean qui peut être définie dans la boîte de dialogue Propriétés du projet. Par défaut, toutes les configurations pour un projet définissent TRACE. Lorsque TRACE est défini, les méthodes de la classe Trace génèrent un résultat vers la fenêtre Sortie. Lorsque la constante n'est pas définie, les méthodes de classe Trace ne sont pas compilées et aucune sortie Trace n'est générée.

VBC_VER

Nombre représentant la version de Visual Basic au format major.minor. Le numéro de version de Visual Basic 2005 est 8.0.

_MYTYPE

Chaîne représentant le type de projet créé. Elle contrôle quels sont les objets My disponibles dans le code. Pour plus d'informations, consultez Comment My dépend du type de projet.

Vous pouvez utiliser ces constantes uniquement pour la compilation conditionnelle ; ils ne peuvent pas être utilisés dans un code exécutable.

Exemple

Cet exemple utilise la constante de compilation conditionnelle TARGET pour déterminer s'il faut compiler certaines instructions.

#If TARGET = "winexe" Then
        ' Insert code to be compiled for a Windows application.
#ElseIf TARGET = "exe" Then
        ' Insert code to be compiled for a console application.
#End If

Configuration requise

L'environnement de développement intégré Visual Studio définit les constantes de compilation conditionnelles CONFIG, DEBUG, TRACEet _MYTYPE.

Le compilateur Visual Basic définit les constantes de compilation conditionnelles TARGET et VBC_VER. Les constantes TARGET, VBC_VER et _MYTYPE ne sont pas disponibles dans les versions de compilateur antérieures à Visual Basic 2005.

Voir aussi

Tâches

Comment : déclarer des constantes de compilation conditionnelle

Concepts

Vue d'ensemble de la compilation conditionnelle

Comment My dépend du type de projet

Référence

#If...Then...#Else, directives

#Const, directive

/target (Visual Basic)