Commandes et commutateurs Visual Studio
Mise à jour : novembre 2007
Les commandes Visual Studio vous permettent d'interagir directement avec l'environnement de développement intégré (IDE, Integrated Development Environment) à partir du clavier. Nombre de boîtes de dialogue, fenêtres et commandes de menu de l'IDE ont un équivalent en ligne de commande que vous pouvez taper dans la Commande, fenêtre, la Fenêtre Exécution, ou la Zone Rechercher/Commande pour afficher une boîte de dialogue ou exécuter une commande.
Les commandes Visual Studio obéissent aux règles de syntaxe générales expliquées ci-après. L'ensemble des commandes disponibles inclut toutes les commandes répertoriées dans Clavier, Environnement, boîte de dialogue Options et dans Commandes, onglet, boîte de dialogue Personnaliser (Visual Studio), ainsi que les alias et macros définis par l'utilisateur.
Génération à partir de la ligne de commande
Pour plus d'informations sur la génération de projets dans les langages de programmation Visual Studio à partir de la ligne de commande, consultez Génération à partir de la ligne de commande (Visual Basic), Génération à partir de la ligne de commande avec csc.exe (Visual C#), Options VCBUILD (Visual C++) et Génération à partir de la ligne de commande. Pour plus d'informations sur la configuration d'un fichier de schéma XML MSBuild pour générer des projets, consultez Référence MSBuild.
Syntaxe des commandes Visual Studio
Les commandes Visual Studio peuvent être entrées dans la fenêtre Commande, la fenêtre Exécution ou la zone Rechercher/Commande. Dans les deux cas, vous devez faire précéder la ligne de commande d'un signe supérieur à (>) pour signifier qu'il s'agit d'une commande et pas d'une opération de recherche ou de débogage.
Pour plus d'informations sur la syntaxe des commandes, consultez Commandes Visual Studio utilisant des arguments et Commutateurs de la ligne de commande de Devenv.
Beaucoup de commandes peuvent être écrites dans l'un ou l'autre de deux formats, à l'aide de la syntaxe de commande complète, ou d'une forme abrégée appelée alias.
Noms de commandes complets
La syntaxe complète des commandes est basée sur le nom de commande complet répertorié dans Clavier, Environnement, boîte de dialogue Options. Dans la plupart des cas, la syntaxe complète reflète l'emplacement de la commande dans le système de menus de l'IDE. Les noms de commandes complets obéissent aux règles de syntaxe suivantes.
Les catégories de commande (telles que les menus) et les noms de commandes sont séparés par un point (.).
Les noms de commandes ne doivent contenir ni espace ni signe de ponctuation.
Par exemple, la commande qui affiche la Nouveau fichier, boîte de dialogue apparaît dans Clavier, Environnement, Options comme un enfant de la commande File. Pour afficher cette boîte de dialogue, tapez la commande suivante dans la fenêtre Commande, la fenêtre Exécution ou la zone Rechercher/Commande, puis appuyez sur ENTRÉE.
>File.NewFile
La boîte de dialogue Nouveau fichier s'affiche pour que vous puissiez sélectionner un fichier.
Alias de commande
Vous pouvez associer des noms courts, ou alias, à des noms de commandes complets pour vous souvenir plus facilement des commandes et les entrer plus rapidement. Visual Studio est fourni avec un ensemble d'alias prédéfinis. Par exemple, la commande qui affiche la boîte de dialogue Nouveau fichier a l'alias par défaut nf. Pour plus d'informations, consultez Alias prédéfinis de commandes Visual Studio.
Vous avez également la possibilité de créer vos propres alias personnalisés ou de modifier les alias prédéfinis à l'aide de la commande alias. Par exemple, entrez la ligne de commande suivante si vous souhaitez créer l'alias pour la commande Edit.MakeUpperCase :
>alias upper Edit.MakeUpperCase
Si vous sélectionnez ensuite du texte dans l'éditeur et que vous entrez >upper dans la fenêtre Commande, la fenêtre Exécution ou la zone Rechercher/Commande, ce texte s'affiche en majuscules. Vous pouvez également créer des alias qui contiennent des noms de commandes et leurs arguments.
Pour afficher une liste de tous les alias actuels, entrez la commande suivante dans la fenêtre Commande :
>alias
Commandes utilisant des arguments
Pour certaines commandes, vous pouvez spécifier des arguments, tels que des noms de fichiers ou des commutateurs qui exécutent une commande, sans avoir besoin d'afficher des boîtes de dialogue ou d'autres éléments de l'interface utilisateur. Par exemple, la commande File.NewFile, entrée sans commutateurs, affiche la boîte de dialogue Nouveau fichier. Vous pouvez également créer un nouveau fichier à partir d'un modèle, sans afficher la boîte de dialogue Nouveau fichier, en incluant le commutateur /t. L'exemple suivant crée un nouveau fichier texte, appelé Mytext.txt, basé sur le modèle General\Text File et l'ouvre dans l'éditeur de code source.
>File.NewFile Mytext /t:"General\Text File" /e:"Source Code (text) Editor"
.gif "Remarque") Remarque : |
|---|
Les arguments de commande doivent être entrés dans l'ordre spécifié pour la commande. Les commutateurs et leurs arguments peuvent être placés dans n'importe quel ordre. |
Les commandes et les arguments obéissent aux règles de syntaxe suivantes :
Les noms de commandes et les arguments sont séparés par des espaces.
Les valeurs d'argument qui comportent des espaces doivent être entourées de guillemets.
Utilisez le signe d'insertion (^) pour spécifier un caractère d'échappement.
Plusieurs abréviations d'argument à un caractère peuvent être regroupées. Par exemple, vous pouvez entrer les abréviations d'argument à un seul caractère /case (/c) et /word (/w) sous la forme /cw au lieu de /c /w.
De nombreux commutateurs de nom de commande possèdent un nom court et un nom complet qui peuvent être utilisés indifféremment. Par exemple, le commutateur /case de la commande Edit.Find peut également s'écrire /c. Pour obtenir la liste complète, consultez Commandes Visual Studio utilisant des arguments.
Caractères d'échappement
La présence d'un signe d'insertion (^) dans une ligne de commande signifie que le caractère situé juste après ce signe est interprété littéralement, et non comme un caractère de contrôle. Cela permet d'incorporer des guillemets ("), des espaces, des barres obliques de début, des signes d'insertion ou tout autre caractère littéral dans une valeur de paramètre ou de commutateur (mais pas dans les noms de commutateurs). Par exemple :
>Edit.Find ^^t /regex
Un signe d'insertion a la même fonction qu'il soit ou non placé entre guillemets. Si le signe d'insertion est le dernier caractère de la ligne de commande, il est ignoré.
Saisie semi-automatique des commandes
La fenêtre Commande, la fenêtre Exécution et la zone Rechercher/Commande fournissent la saisie semi-automatique pour l'entrée de noms et d'alias de commandes. La liste de saisie semi-automatique présente toutes les correspondances possibles avec les noms de commandes ou les alias entrés, sans tenir compte de la disponibilité de la commande. Si vous entrez ou sélectionnez une commande non disponible, la barre d'état affiche le message "La commande n'est pas disponible.", et la commande est ignorée.
Noms de commandes internationaux
Dans les versions localisées de l'environnement de développement intégré (IDE, Integrated Development Environment), il est possible d'entrer les noms de commandes soit dans la langue native de l'environnement de développement intégré, soit en anglais. Par exemple, dans l'environnement de développement intégré français, vous pouvez taper soit File.NewFile, soit Fichier.NouveauFichier pour exécuter la même commande.
Les noms de macros ont un comportement semblable à celui des noms de commandes. Bien qu'il soit possible d'enregistrer des macros sous un nom localisé, il vaut mieux utiliser des noms anglais pour préserver la compatibilité entre la version anglaise et les versions localisées de Visual Studio. En effet, si toutes les versions localisées de l'environnement de développement intégré comprennent les commandes en anglais, rien ne garantit que toutes les versions localisées de l'environnement de développement intégré comprennent une langue localisée différente.