Comment : créer un fichier .vsctHow to: Create a .vsct file

Il existe plusieurs façons de créer une configuration de table de commande basé sur XML Visual Studio (.vsct) fichier.There are several ways to create an XML-based Visual Studio command table configuration (.vsct) file.

  • Vous pouvez créer un nouveau VSPackage s’affiche dans le Visual StudioVisual Studio modèle de package.You can create a new VSPackage in the Visual StudioVisual Studio package template.

  • Vous pouvez utiliser le compilateur de configuration de table de commande basé sur XML, Vsct.exe, pour générer un fichier à partir d’un existant .ctc fichier.You can use the XML-based command table configuration compiler, Vsct.exe, to generate a file from an existing .ctc file.

  • Vous pouvez utiliser Vsct.exe pour générer un .vsct fichier depuis une .cto fichier.You can use Vsct.exe to generate a .vsct file from an existing .cto file.

  • Vous pouvez créer manuellement un nouveau .vsct fichier.You can manually create a new .vsct file.

    Cet article explique comment créer manuellement un nouveau .vsct fichier.This article explains how to manually create a new .vsct file.

Pour créer manuellement un nouveau fichier .vsctTo manually create a new .vsct file

  1. Démarrez Visual StudioVisual Studio.Start Visual StudioVisual Studio.

  2. Sur le fichier menu, pointez sur New, puis cliquez sur fichier.On the File menu, point to New, and then click File.

  3. Dans le modèles volet, cliquez sur fichier XML puis cliquez sur Open.In the Templates pane, click XML File and then click Open.

  4. Sur le vue menu, cliquez sur propriétés pour afficher les propriétés du fichier XML.On the View menu, click Properties to display the properties of the XML file.

  5. Dans le propriétés fenêtre, cliquez sur le Parcourir bouton sur le schémas propriété.In the Properties window, click the Browse button on the Schemas property.

  6. Dans la liste des schémas XSD, sélectionnez le vsct.xsd schéma.In the list of XSD schemas, select the vsct.xsd schema. Si elle n’est pas dans la liste, cliquez sur ajouter , puis recherchez le fichier sur un lecteur local.If it is not in the list, click Add and then find the file on a local drive. Cliquez sur OK lorsque vous avez terminé.Click OK when you are finished.

  7. Dans le fichier XML, tapez < CommandTable , puis appuyez sur onglet. Fermer la balise en tapant >.In the XML file, type <CommandTable and then press Tab. Close the tag by typing >.

    Cette action crée un base .vsct fichier.This action creates a basic .vsct file.

  8. Renseignez les éléments du fichier XML que vous souhaitez ajouter, selon le référence du schéma XML VSCT.Fill in the elements of the XML file that you want to add, according to the VSCT XML schema reference. Pour plus d’informations, consultez créer des fichiers .vsctFor more information, see Author .vsct files

Comment : créer un fichier .vsct à partir d’un fichier .ctc existantHow to: Create a .vsct File from an existing .ctc file

Vous pouvez créer une base de XML .vsct fichier à partir d’une table existante de la commande .ctc fichier source.You can create an XML-based .vsct file from an existing command table .ctc source file. Ce faisant, vous pouvez tirer parti du nouveau basé sur XML Visual StudioVisual Studio format de compilateur (VSTC) de table de commande.By doing this, you can take advantage of the new XML-based Visual StudioVisual Studio command table (VSCT) compiler format.

Pour créer un fichier .vsct à partir d’un fichier .ctcTo create a .vsct file from a .ctc file

  1. Obtenez une copie du langage Perl.Obtain a copy of the Perl language.

  2. Obtenir une copie du script Perl ConvertCTCToVSCT.pl, généralement situé dans le <chemin d’installation de Visual Studio SDK > \VisualStudioIntegration\Tools\bin dossier.Obtain a copy of the Perl script ConvertCTCToVSCT.pl, typically located in the <Visual Studio SDK installation path>\VisualStudioIntegration\Tools\bin folder.

  3. Obtenir une copie de la .ctc fichier source que vous souhaitez convertir.Obtain a copy of the .ctc source file that you want to convert.

  4. Placez les fichiers dans le même répertoire.Place the files in the same directory.

  5. Dans la Visual StudioVisual Studio fenêtre d’invite de commandes, accédez au répertoire.In the Visual StudioVisual Studio command prompt window, navigate to the directory.

  6. TypeType

    perl.exe ConvertCTCtoVSCT.pl PkgCmd.ctc PkgCmd.vsct  
    

    PkgCmd.ctc est le nom de la .ctc fichier et PkgCmd.vsct est le nom de la .vsct fichier que vous souhaitez créer.where PkgCmd.ctc is the name of the .ctc file and PkgCmd.vsct is the name of the .vsct file that you want to create.

    Cette action crée un nouveau .vsct fichier de source de table de commande XML.This action creates a new .vsct XML command table source file. Vous pouvez compiler le fichier à l’aide de Vsct.exe, le compilateur VSCT, comme vous le feriez pour n’importe quel autre .vsct fichier.You can compile the file by using Vsct.exe, the VSCT compiler, as you would any other .vsct file.

    Note

    Vous pouvez améliorer la lisibilité de la .vsct fichier en reformatant les commentaires XML.You can improve the readability of the .vsct file by reformatting the XML comments.

Comment : créer un fichier .vsct à partir d’un fichier .cto existantHow to: Create a .vsct file from an existing .cto file

Vous pouvez créer une base de XML .vsct fichier à partir d’un fichier binaire existant .cto fichier.You can create an XML-based .vsct file from an existing binary .cto file. Cela vous permet de tirer parti du nouveau format de compilateur de la table de commande.Doing this allows you to take advantage of the new command table compiler format. Ce processus fonctionne même si le .cto fichier a été compilé à partir d’un .ctc fichier.This process works even if the .cto file was compiled from a .ctc file. Vous pouvez modifier et compiler le .vsct fichier dans un autre fichier .cto.You can edit and compile the .vsct file into another .cto file.

Pour créer un fichier .vsct à partir d’un fichier .ctoTo create a .vsct file from a .cto file

  1. Obtenir des copies de la .cto fichier et son .ctsym fichier.Obtain copies of the .cto file and its corresponding .ctsym file.

  2. Placez les fichiers dans le même répertoire que le vsct.exe compilateur.Place the files into the same directory as the vsct.exe compiler.

  3. À l’invite de commandes Visual Studio, accédez au répertoire qui contient le .cto et .ctsym fichiers.At the Visual Studio command prompt, go to the directory that contains the .cto and .ctsym files.

  4. TypeType

    vsct.exe <ctofilename>.cto <vsctfilename>.vsct -S<symfilename>.ctsym
    

    où <ctofilename> est le nom de la .cto fichier, <vsctfilename> est le nom de la .vsct fichier que vous souhaitez créer et <symfilename> est le nom de la .ctsym fichier.where <ctofilename> is the name of the .cto file, <vsctfilename> is the name of the .vsct file you want to create, and <symfilename> is the name of the .ctsym file.

    Ce processus crée un nouveau .vsct fichier du compilateur de table de commande XML.This process creates a new .vsct XML command table compiler file. Vous pouvez modifier et compiler le fichier avec vsct.exe, le compilateur vsct, comme vous le feriez pour n’importe quel autre .vsct fichier.You can edit and compile the file with vsct.exe, the vsct compiler, as you would any other .vsct file.

Compiler le codeCompile the code

Simplement en ajoutant un .vsct fichier à un projet n’entraîne pas se compiler.Simply adding a .vsct file to a project does not cause it to compile. Vous devez l’incorporer dans le processus de génération.You must incorporate it in the build process.

Pour ajouter un fichier .vsct à la compilation du projetTo add a .vsct file to project compilation

  1. Ouvrez votre fichier projet dans l’éditeur.Open your project file in the editor. Si le projet est chargé, vous devez tout d’abord le décharger.If the project is loaded, you must unload it first.

  2. Ajouter un élément ItemGroup qui contient un VSCTCompile élément, comme indiqué dans l’exemple suivant.Add an ItemGroup element that contains a VSCTCompile element, as shown in the following example.

    <ItemGroup>  
      <VSCTCompile Include="TopLevelMenu.vsct">  
        <ResourceName>Menus.ctmenu</ResourceName>  
      </VSCTCompile>  
    </ItemGroup>  
    

    Le ResourceName élément doit toujours être défini sur Menus.ctmenu.The ResourceName element should always be set to Menus.ctmenu.

  3. Si votre projet contient un .resx , ajoutez un EmbeddedResource élément contenant un MergeWithCTO élément, comme indiqué dans l’exemple suivant :If your project contains a .resx file, add an EmbeddedResource element that contains a MergeWithCTO element, as shown in the following example:

    <EmbeddedResource Include="VSPackage.resx">  
      <MergeWithCTO>true</MergeWithCTO>  
      <ManifestResourceName>VSPackage</ManifestResourceName>  
    </EmbeddedResource>  
    

    Ce balisage doit passer à l’intérieur du ItemGroup élément qui contient des ressources incorporées.This markup should go inside the ItemGroup element that contains embedded resources.

  4. Ouvrez le fichier de package, généralement nommé <nom_projet>Package.cs ou <nom_projet>Package.vb, dans l’éditeur.Open the package file, usually named <ProjectName>Package.cs or <ProjectName>Package.vb, in the editor.

  5. Ajouter un ProvideMenuResource d’attribut à la classe de package, comme illustré dans l’exemple suivant.Add a ProvideMenuResource attribute to the package class, as shown in the following example.

    [ProvideMenuResource("Menus.ctmenu", 1)]  
    

    La première valeur du paramètre doit correspondre à la valeur de la ResourceName attribut vous défini dans le fichier projet.The first parameter value must match the value of the ResourceName attribute you defined in the project file.

Voir aussiSee also

Fichiers .vsct auteur Author .vsct files
Visual Studio fichiers command table (.vsct) Visual Studio command table (.vsct) files
Référence du schéma XML VSCTVSCT XML schema reference