Partager via

Page de Compilation, Concepteur de projets (Visual Basic)

Remarque

Cette page fait référence à l’expérience du Concepteur de projets dans Visual Studio 2019 et pour les projets .NET Framework avec Visual Studio 2022.

Utilisez la page Compiler du Concepteur de projets pour spécifier des instructions de compilation. Vous pouvez également spécifier des options de compilateur avancées et des événements de pré-génération ou post-build sur cette page.

Pour accéder à la page Compiler , choisissez un nœud de projet (et non le nœud Solution ) dans l’Explorateur de solutions. Choisissez Ensuite Project, Propriétés dans la barre de menus. Lorsque le Concepteur de projets s’affiche, cliquez sur l’onglet Compiler .

Remarque

Votre ordinateur peut afficher différents noms ou emplacements pour certains des éléments de l’interface utilisateur Visual Studio de cet article. Vous utilisez peut-être une édition différente de Visual Studio ou des paramètres d’environnement différents. Pour plus d’informations, consultez Personnaliser l’IDE.

Configuration et plateforme

Les paramètres suivants vous permettent de sélectionner la configuration et la plateforme à afficher ou à modifier.

Remarque

Avec des configurations de build simplifiées, le système de projet détermine s’il faut générer une version de débogage ou de mise en production. Par conséquent, les listes configuration et plateforme ne sont pas affichées.

Configuration

Spécifie les paramètres de configuration à afficher ou modifier. Les paramètres sont Debug (valeur par défaut), Release ou All Configurations. Pour plus d’informations, consultez Présentation des configurations de build et guide pratique pour créer et modifier des configurations.

Plateforme

Spécifie les paramètres de plateforme à afficher ou modifier. Vous pouvez spécifier n’importe quel processeur (valeur par défaut), x64 ou x86.

Options de configuration du compilateur

Les paramètres suivants vous permettent de définir les options de configuration du compilateur.

Chemin de sortie de build

Spécifie l’emplacement des fichiers de sortie pour la configuration de ce projet. Tapez le chemin d’accès de la sortie de build dans cette zone, ou cliquez sur le bouton Parcourir pour sélectionner un chemin d’accès. Notez que le chemin d’accès est relatif ; si vous entrez un chemin d’accès absolu, il est enregistré en tant que relatif. Le chemin d’accès par défaut est bin\Debug\ ou bin\Release\.

Avec des configurations de build simplifiées, le système de projet détermine s’il faut générer une version de débogage ou de mise en production. La commande Générer à partir du menu Déboguer (F5) place la build dans l’emplacement de débogage, quel que soit le chemin de sortie que vous spécifiez. Toutefois, la commande Build à partir du menu Build le place dans l’emplacement que vous spécifiez.

Option explicite

Spécifie s’il faut autoriser la déclaration implicite de variables. Sélectionnez Activé pour exiger une déclaration explicite de variables. Cela entraîne le signalement d’erreurs par le compilateur si les variables ne sont pas déclarées avant qu’elles ne soient utilisées. Sélectionnez Désactivé pour autoriser la déclaration implicite de variables.

Ce paramètre correspond à l’option du compilateur /optionexplicit .

Si un fichier de code source contient une instruction Option Explicit, la ou On la Off valeur de l’instruction remplace le paramètre Option Explicit sur la page Compiler.

Lorsque vous créez un projet, le paramètre Option Explicit sur la page Compiler est défini sur la valeur du paramètre Option Explicit dans la boîte de dialogue Options . Pour afficher ou modifier le paramètre dans cette boîte de dialogue, dans le menu Outils , cliquez sur Options. Dans la boîte de dialogue Options , développez Projets et solutions, puis cliquez sur Vb Defaults. Le paramètre par défaut initial d’Option Explicit dans vb Defaults est Activé.

La définition d’option explicite n’est Off généralement pas une bonne pratique. Vous pouvez mal orthographié un nom de variable dans un ou plusieurs emplacements, ce qui entraînerait des résultats inattendus lorsque le programme est exécuté.

Option stricte

Spécifie s’il faut appliquer une sémantique de type strict. Lorsque l’option Strict est activée, les conditions suivantes provoquent une erreur au moment de la compilation :

  • Conversions restrictives implicites

  • Liaison tardive

  • Saisie implicite qui entraîne un Object type

Les erreurs de conversion restrictive implicite se produisent lorsqu’il existe une conversion de type de données implicite qui est une conversion restrictive. Pour plus d’informations, consultez l’instruction Option Strict, les conversions implicites et explicites, ainsi que les conversions d’élargissement et de réduction.

Un objet est lié tardivement lorsqu’il est affecté à une propriété ou à une méthode d’une variable déclarée comme de type Object. Pour plus d’informations, consultez l’instruction Option Strict et la liaison anticipée et tardive.

Les erreurs de type d’objet implicite se produisent lorsqu’un type approprié ne peut pas être déduit pour une variable déclarée. Par conséquent, un type est Object déduit. Cela se produit principalement lorsque vous utilisez une Dim instruction pour déclarer une variable sans utiliser de As clause et Option Infer est désactivée. Pour plus d’informations, consultez l’instruction Option Strict, l’instruction Option Infer et la spécification du langage Visual Basic.

Le paramètre Option Strict correspond à l’option du compilateur /optionstrict .

Si un fichier de code source contient une instruction Option Strict, la ou On la Off valeur de l’instruction remplace le paramètre Option Strict sur la page Compilation.

Lorsque vous créez un projet, le paramètre Option Strict sur la page Compiler est défini sur la valeur du paramètre Option Strict dans la boîte de dialogue Options . Pour afficher ou modifier le paramètre dans cette boîte de dialogue, dans le menu Outils , cliquez sur Options. Dans la boîte de dialogue Options , développez Projets et solutions, puis cliquez sur Vb Defaults. Le paramètre par défaut initial d’Option Strict dans VB Defaults est Désactivé.

Avertissements individuels stricts de l’option

La section Configurations d’avertissement de la page Compilation contient des paramètres qui correspondent aux trois conditions qui provoquent une erreur au moment de la compilation.Option Strict Voici les paramètres suivants :

  • Conversion implicite

  • Liaison tardive ; l’appel peut échouer au moment de l’exécution

  • Type implicite ; objet supposé

Lorsque vous définissez Option Strict sur Activé, les trois de ces paramètres de configuration d’avertissement sont définis sur Erreur. Lorsque vous définissez Option Strict sur Désactivé, les trois paramètres sont définis sur Aucun.

Vous pouvez modifier individuellement chaque paramètre de configuration d’avertissement en Aucun, Avertissement ou Erreur. Si les trois paramètres de configuration d’avertissement sont définis sur Erreur, On apparaît dans la Option strict zone. Si les trois sont définies sur None, Off apparaît dans cette zone. Pour toute autre combinaison de ces paramètres, (personnalisé) s’affiche.

Comparaison d’options

Spécifie le type de comparaison de chaînes à utiliser. Sélectionnez Binaire pour indiquer au compilateur d’utiliser des comparaisons de chaînes binaires sensibles à la casse. Sélectionnez Texte pour utiliser des comparaisons de chaînes de texte propres aux paramètres régionaux et sans respect de la casse.

Ce paramètre correspond à l’option du compilateur /optioncompare .

Si un fichier de code source contient une instruction Option Compare, l’instruction ou Binary la Text valeur de l’instruction remplace le paramètre Comparaison d’options sur la page Compilation.

Lorsque vous créez un projet, le paramètre Comparaison d’options sur la page Compiler est défini sur la valeur du paramètre Comparaison d’options dans la boîte de dialogue Options . Pour afficher ou modifier le paramètre dans cette boîte de dialogue, dans le menu Outils , cliquez sur Options. Dans la boîte de dialogue Options , développez Projets et solutions, puis cliquez sur Vb Defaults. Le paramètre par défaut initial de la comparaison d’options dans les valeurs par défaut VB est Binaire.

Inférence d’option

Spécifie s’il faut autoriser l’inférence de type local dans les déclarations de variables. Sélectionnez Activé pour autoriser l’utilisation de l’inférence de type local. Sélectionnez Désactivé pour bloquer l’inférence de type local.

Ce paramètre correspond à l’option du compilateur /optioninfer .

Si un fichier de code source contient une instruction Option Infer, la ou On la Off valeur de l’instruction remplace le paramètre Option Infer sur la page Compilation.

Lorsque vous créez un projet, le paramètre Option Infer sur la page Compiler est défini sur la valeur du paramètre Option Infer dans la boîte de dialogue Options . Pour afficher ou modifier le paramètre dans cette boîte de dialogue, dans le menu Outils , cliquez sur Options. Dans la boîte de dialogue Options , développez Projets et solutions, puis cliquez sur Vb Defaults. Le paramètre par défaut initial d’Option Infer dans VB Defaults est Activé.

Processeur cible

Spécifie le processeur à cibler par le fichier de sortie. Spécifiez x86 pour n’importe quel processeur compatible Intel 32 bits, x64 pour n’importe quel processeur compatible Intel 64 bits, ARM pour n’importe quel processeur ARM ou tout processeur pour spécifier qu’un processeur est acceptable. Toute UC est la valeur par défaut pour les nouveaux projets, car elle permet à l’application de s’exécuter sur le plus grand nombre de types matériels.

Pour plus d’informations, consultez /platform (Visual Basic).

Préférer 32 bits

Si la case à cocher Prefer32 bits est activée, l’application s’exécute en tant qu’application 32 bits sur les versions 32 bits et 64 bits de Windows. Sinon, l’application s’exécute en tant qu’application 32 bits sur des versions 32 bits de Windows et en tant qu’application 64 bits sur des versions 64 bits de Windows.

L’exécution en tant qu’application 64 bits double la taille du pointeur et peut entraîner des problèmes de compatibilité avec les bibliothèques exclusivement 32 bits. Il est judicieux d’exécuter une application en tant que 64 bits uniquement si elle s’exécute beaucoup plus rapidement ou a besoin de plus de 4 Go de mémoire.

Cette case à cocher est disponible uniquement si toutes les conditions suivantes sont remplies :

  • Dans la page compilation, la liste du processeur cible est définie sur n’importe quel processeur.

  • Dans la page Application, la liste de types d’application spécifie que le projet est une application.

  • Dans la page Application, la liste du framework cible spécifie le .NET Framework 4.5.

Configurations d’avertissement

Ce tableau répertorie les conditions de build et le niveau de notification correspondant de None, Warning ou Error pour chacun d’eux.

Par défaut, tous les avertissements du compilateur sont ajoutés à la liste des tâches pendant la compilation. Sélectionnez Désactiver tous les avertissements pour indiquer au compilateur de ne pas émettre d’avertissements ou d’erreurs. Sélectionnez Traiter tous les avertissements comme des erreurs si vous souhaitez que le compilateur traite les avertissements comme des erreurs qui doivent être corrigées.

Désactiver tous les avertissements

Spécifie s’il faut autoriser le compilateur à émettre des notifications comme spécifié dans la table Condition et Notification décrite précédemment dans ce document. Par défaut, cette case à cocher est désactivée. Activez cette case à cocher pour indiquer au compilateur de ne pas émettre d’avertissements ou d’erreurs.

Ce paramètre correspond à l’option du compilateur /nowarn .

Traiter tous les avertissements comme des erreurs

Spécifie comment traiter les avertissements. Par défaut, cette case à cocher est désactivée afin que toutes les notifications d’avertissement restent définies sur Avertissement. Activez cette case à cocher pour modifier toutes les notifications d’avertissement en cas d’erreur.

Cette option est disponible uniquement si tous les avertissements sont désactivés .

Générer un fichier de documentation XML

Spécifie s’il faut générer des informations de documentation. Par défaut, cette case à cocher est cochée, demandant au compilateur de générer des informations de documentation et de l’inclure dans un fichier XML. Désactivez cette case à cocher pour indiquer au compilateur de ne pas créer de documentation.

Ce paramètre correspond à l’option du compilateur /doc .

S’inscrire à COM Interop

Spécifie si votre application managée expose un objet COM (wrapper COM pouvant être appelé) qui permet à un objet COM d’interagir avec l’application.

Par défaut, cette case à cocher est désactivée, qui spécifie que l’application n’autorise pas l’interopérabilité COM. Activez cette case à cocher pour autoriser l’interopérabilité COM.

Cette option n’est pas disponible pour les projets d’application Windows ou d’application console.

Événements de génération

Cliquez sur ce bouton pour accéder à la boîte de dialogue Événements de build . Utilisez cette boîte de dialogue pour spécifier des instructions de configuration de pré-build et post-build pour le projet. Cette boîte de dialogue s’applique uniquement aux projets Visual Basic. Pour plus d’informations, consultez la boîte de dialogue Générer des événements (Visual Basic).

Options de compilation avancées

Cliquez sur ce bouton pour accéder à la boîte de dialogue Paramètres AdvancedCompiler . Utilisez la boîte de dialogue Paramètres AdvancedCompiler pour spécifier les propriétés avancées de configuration de build d’un projet. Cette boîte de dialogue s’applique uniquement aux projets Visual Basic. Pour plus d’informations, consultez la boîte de dialogue Paramètres du compilateur avancés (Visual Basic).

Voir aussi