Condividi tramite


Creare un file con estensione vsct

Esistono diversi modi per creare un file di configurazione della tabella dei comandi di Visual Studio basato su XML (con estensione vsct).

  • È possibile creare un nuovo pacchetto VSPackage nel modello di pacchetto di Visual Studio.

  • È possibile usare il compilatore di configurazione della tabella dei comandi basato su XML, Vsct.exe, per generare un file da un file con estensione ctc esistente.

  • È possibile usare Vsct.exe per generare un file vsct da un file con estensione cto esistente.

  • È possibile creare manualmente un nuovo file con estensione vsct .

    Questo articolo illustra come creare manualmente un nuovo file vsct .

Per creare manualmente un nuovo file con estensione vsct

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu File, quindi fare clic su File.

  3. Nel riquadro Modelli fare clic su File XML e quindi su Apri.

  4. Scegliere Proprietà dal menu Visualizza per visualizzare le proprietà del file XML.

  5. Nella finestra Proprietà fare clic sul pulsante Sfoglia nella proprietà Schemi.

  6. Nell'elenco degli schemi XSD selezionare lo schema vsct.xsd . Se non è presente nell'elenco, fare clic su Aggiungi e quindi trovare il file in un'unità locale. Al termine, fare clic su OK.

  7. Nel file XML digitare <CommandTable e quindi premere TAB. Chiudere il tag digitando >.

    Questa azione crea un file vsct di base.

  8. Compilare gli elementi del file XML che si desidera aggiungere, in base al riferimento allo schema XML VSCT. Per altre informazioni, vedere Creare file con estensione vsct.

Creare un file con estensione vsct da un file con estensione ctc esistente

È possibile creare un file vsct basato su XML da un file di origine ctc della tabella dei comandi esistente. In questo modo, è possibile sfruttare il nuovo formato del compilatore vsCT (Visual Studio Command Table) basato su XML.

Per creare un file con estensione vsct da un file CTC

  1. Ottenere una copia del linguaggio Perl.

  2. Ottenere una copia dello script Perl ConvertCTCToVSCT.pl, in genere disponibile nella <cartella Visual Studio SDK\>VisualStudioIntegration\Tools\bin.

  3. Ottenere una copia del file di origine con estensione ctc da convertire.

  4. Inserire i file nella stessa directory.

  5. Nella finestra del prompt dei comandi di Visual Studio passare alla directory .

  6. Type

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

    dove PkgCmd.ctc è il nome del file con estensione ctc e PkgCmd.vsct è il nome del file vsct che si desidera creare.

    Questa azione crea un nuovo file di origine della tabella dei comandi XML vsct . È possibile compilare il file usando Vsct.exe, il compilatore VSCT, come qualsiasi altro file vsct .

    Nota

    È possibile migliorare la leggibilità del file con estensione vsct riformattando i commenti XML.

Creare un file con estensione vsct da un file con estensione cto esistente

È possibile creare un file con estensione vsct basato su XML da un file binario con estensione cto esistente. Questa operazione consente di sfruttare il nuovo formato di compilatore della tabella comandi. Questo processo funziona anche se il file con estensione cto è stato compilato da un file con estensione ctc . È possibile modificare e compilare il file vsct in un altro file con estensione cto.

Per creare un file con estensione vsct da un file CTO

  1. Ottenere copie del file con estensione cto e del file con estensione ctsym corrispondente.

  2. Inserire i file nella stessa directory del compilatore vsct.exe .

  3. Al prompt dei comandi di Visual Studio passare alla directory contenente i file con estensione cto e ctsym .

  4. Type

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

    dove <ctofilename> è il nome del file con estensione cto , <vsctfilename> è il nome del file con estensione vsct che si vuole creare e <symfilename> è il nome del file con estensione ctsym .

    Questo processo crea un nuovo file del compilatore della tabella dei comandi XML vsct . È possibile modificare e compilare il file con vsct.exe, il compilatore vsct, come qualsiasi altro file vsct .

Compilare il codice

L'aggiunta di un file con estensione vsct a un progetto non comporta la compilazione. È necessario incorporarlo nel processo di compilazione.

Per aggiungere un file con estensione vsct alla compilazione del progetto

  1. Aprire il file di progetto nell'editor. Se il progetto viene caricato, è necessario prima scaricarlo.

  2. Aggiungere un elemento ItemGroup che contiene un VSCTCompile elemento , come illustrato nell'esempio seguente.

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

    L'elemento ResourceName deve essere sempre impostato su Menus.ctmenu.

  3. Se il progetto contiene un file con estensione resx , aggiungere un EmbeddedResource elemento che contiene un MergeWithCTO elemento, come illustrato nell'esempio seguente:

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

    Questo markup deve entrare all'interno dell'elemento ItemGroup che contiene risorse incorporate.

  4. Aprire il file del pacchetto, in genere denominato <ProjectName>Package.cs o< ProjectName>Package.vb, nell'editor.

  5. Aggiungere un ProvideMenuResource attributo alla classe del pacchetto, come illustrato nell'esempio seguente.

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

    Il primo valore del parametro deve corrispondere al valore dell'attributo ResourceName definito nel file di progetto.