Créer un fichier .vsct

Article
01/13/2024

Il existe plusieurs façons de créer un fichier de table de commandes Visual Studio basé sur XML (.vsct).

Vous pouvez créer un VSPackage dans le modèle de package Visual Studio.
Vous pouvez utiliser le compilateur de configuration de table de commandes XML, Vsct.exe, pour générer un fichier à partir d’un fichier .ctc existant.
Vous pouvez utiliser Vsct.exe pour générer un fichier .vsct à partir d’un fichier .cto existant.
Vous pouvez créer manuellement un fichier .vsct .

Cet article explique comment créer manuellement un fichier .vsct .

Pour créer manuellement un fichier .vsct

Démarrez Visual Studio.
Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Fichier.
Dans le volet Modèles , cliquez sur Fichier XML, puis sur Ouvrir.
Dans le menu Affichage , cliquez sur Propriétés pour afficher les propriétés du fichier XML.
Dans la fenêtre Propriétés , cliquez sur le bouton Parcourir dans la propriété Schémas .
Dans la liste des schémas XSD, sélectionnez le schéma vsct.xsd . S’il n’est pas dans la liste, cliquez sur Ajouter , puis recherchez le fichier sur un lecteur local. Cliquez sur OK lorsque vous avez terminé.
Dans le fichier XML, tapez <CommandTable , puis appuyez sur Tab. Fermez la balise en tapant >.

Cette action crée un fichier .vsct de base.
Renseignez les éléments du fichier XML que vous souhaitez ajouter, en fonction de la référence de schéma XML VSCT. Pour plus d’informations, consultez Créer des fichiers .vsct.

Créer un fichier .vsct à partir d’un fichier .ctc existant

Vous pouvez créer un fichier .vsct basé sur XML à partir d’un fichier source .ctc de table de commandes existant. En procédant ainsi, vous pouvez tirer parti du nouveau format de compilateur VSCT (Visual Studio) basé sur XML.

Pour créer un fichier .vsct à partir d’un fichier .ctc

Obtenez une copie du langage Perl.
Obtenez une copie du script Perl ConvertCTCToVSCT.pl, généralement située dans le chemin> d’installation du <Kit de développement logiciel (SDK) Visual Studio\VisualStudioIntegration\Tools\bin.
Obtenez une copie du fichier source .ctc que vous souhaitez convertir.
Placez les fichiers dans le même répertoire.
Dans la fenêtre d’invite de commandes Visual Studio, accédez au répertoire.
Type
```
perl.exe ConvertCTCtoVSCT.pl PkgCmd.ctc PkgCmd.vsct
```
où PkgCmd.ctc est le nom du fichier .ctc et PkgCmd.vsct est le nom du fichier .vsct que vous souhaitez créer.

Cette action crée un fichier source de table de commandes .vsct XML. Vous pouvez compiler le fichier à l’aide de Vsct.exe, le compilateur VSCT, comme vous le feriez pour n’importe quel autre fichier .vsct .

Remarque

Vous pouvez améliorer la lisibilité du fichier .vsct en reformançant les commentaires XML.

Créer un fichier .vsct à partir d’un fichier .cto existant

Vous pouvez créer un fichier .vsct basé sur XML à partir d’un fichier .cto binaire existant. Cela vous permet de tirer parti du nouveau format de compilateur de la table de commande. Ce processus fonctionne même si le fichier .cto a été compilé à partir d’un fichier .ctc . Vous pouvez modifier et compiler le fichier .vsct dans un autre fichier .cto.

Pour créer un fichier .vsct à partir d’un fichier .cto

Obtenez des copies du fichier .cto et son fichier .ctsym correspondant.
Placez les fichiers dans le même répertoire que le compilateur vsct.exe .
À l’invite de commandes Visual Studio, accédez au répertoire qui contient les fichiers .cto et .ctsym .
Type
```
vsct.exe <ctofilename>.cto <vsctfilename>.vsct -S<symfilename>.ctsym
```
où <ctofilename> est le nom du fichier .cto, <vsctfilename est le nom du fichier .vsct que vous souhaitez créer, et <symfilename>> est le nom du fichier .ctsym.

Ce processus crée un fichier de compilateur de table de commandes .vsct XML. Vous pouvez modifier et compiler le fichier avec vsct.exe, le compilateur vsct, comme vous le feriez pour n’importe quel autre fichier .vsct .

Compiler le code

L’ajout d’un fichier .vsct à un projet n’entraîne pas sa compilation. Vous devez l’incorporer dans le processus de génération.

Pour ajouter un fichier .vsct à la compilation du projet

Ouvrez votre fichier projet dans l’éditeur. Si le projet est chargé, vous devez d’abord le décharger.
Ajoutez un élément ItemGroup qui contient un VSCTCompile élément, comme illustré dans l’exemple suivant.
```
<ItemGroup>
  <VSCTCompile Include="TopLevelMenu.vsct">
    <ResourceName>Menus.ctmenu</ResourceName>
  </VSCTCompile>
</ItemGroup>
```
L’élément ResourceName doit toujours être défini sur Menus.ctmenu.
Si votre projet contient un fichier .resx , ajoutez un EmbeddedResource élément qui contient un MergeWithCTO élément, comme illustré dans l’exemple suivant :
```
<EmbeddedResource Include="VSPackage.resx">
  <MergeWithCTO>true</MergeWithCTO>
  <ManifestResourceName>VSPackage</ManifestResourceName>
</EmbeddedResource>
```
Ce balisage doit se rendre à l’intérieur de l’élément ItemGroup qui contient des ressources incorporées.
Ouvrez le fichier de package, généralement nommé <ProjectName>Package.cs ou <ProjectName>Package.vb, dans l’éditeur.
Ajoutez un ProvideMenuResource attribut à la classe de package, comme illustré dans l’exemple suivant.
```
[ProvideMenuResource("Menus.ctmenu", 1)]
```
La première valeur du paramètre doit correspondre à la valeur de l’attribut ResourceName que vous avez défini dans le fichier projet.