Compartir vía

Creación de un archivo .vsct

  • Artículo

Hay varias maneras de crear un archivo de configuración de tabla de comandos (.vsct) basado en XML.

  • Puede crear un nuevo VSPackage en la plantilla de paquete de Visual Studio.

  • Puede usar el compilador de configuración de tabla de comandos basado en XML, Vsct.exe, para generar un archivo a partir de un archivo .ctc existente.

  • Puede usar Vsct.exe para generar un archivo .vsct a partir de un archivo .cto existente.

  • Puede crear manualmente un nuevo archivo .vsct .

    En este artículo se explica cómo crear manualmente un nuevo archivo .vsct .

Para crear manualmente un nuevo archivo .vsct

  1. Inicie Visual Studio.

  2. En el menú Archivo , elija Nuevoy haga clic en Archivo.

  3. En el panel Plantillas , haga clic en Archivo XML y, a continuación, haga clic en Abrir.

  4. En el menú Ver , haga clic en Propiedades para mostrar las propiedades del archivo XML.

  5. En la ventana Propiedades , haga clic en el botón Examinar de la propiedad Esquemas .

  6. En la lista de esquemas XSD, seleccione el esquema vsct.xsd . Si no está en la lista, haga clic en Agregar y busque el archivo en una unidad local. Cuando haya terminado, haga clic en Aceptar.

  7. En el archivo XML, escriba <CommandTable y presione Tab. Para cerrar la etiqueta, escriba >.

    Esta acción crea un archivo .vsct básico.

  8. Rellene los elementos del archivo XML que desea agregar, según la referencia de esquema XML de VSCT. Para obtener más información, vea Crear archivos .vsct.

Crear un archivo .vsct a partir de un archivo .ctc existente

Puede crear un archivo .vsct basado en XML a partir de un archivo de código fuente .ctc de tabla de comandos existente. Al hacerlo, puede aprovechar el nuevo formato del compilador de la tabla de comandos de Visual Studio (VSCT) basado en XML.

Para crear un archivo .vsct a partir de un archivo .ctc existente

  1. Obtenga una copia del lenguaje Perl.

  2. Obtenga una copia del script Perl ConvertCTCToVSCT.pl, que normalmente se encuentra en la carpeta ruta de instalación> del <SDK de Visual Studio\VisualStudioIntegration\Tools\bin.

  3. Obtenga una copia del archivo de origen .ctc que desea convertir.

  4. Coloque los archivos en el mismo directorio.

  5. En la ventana del símbolo del sistema de Visual Studio, vaya al directorio .

  6. Tipo

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

    donde PkgCmd.ctc es el nombre del archivo .ctc y PkgCmd.vsct es el nombre del archivo .vsct que desea crear.

    Esta acción crea un nuevo archivo de origen de tabla de comandos XML .vsct . Puede compilar el archivo mediante Vsct.exe, el compilador de VSCT, como lo haría con cualquier otro archivo .vsct .

    Nota:

    Para mejorar la legibilidad del archivo .vsct , vuelva a formatear los comentarios XML.

Crear un archivo .vsct a partir de un archivo .cto existente

Puede crear un archivo .vsct basado en XML a partir de un archivo .cto binario existente. Si lo hace, podrá aprovechar el nuevo formato de compilador de tabla de comandos. Este proceso funciona incluso si el archivo .cto se compiló a partir de un archivo .ctc . Puede editar y compilar el archivo .vsct en otro archivo .cto.

Para crear un archivo .vsct a partir de un archivo .cto

  1. Obtenga copias del archivo .cto y su archivo .ctsym correspondiente.

  2. Coloque los archivos en el mismo directorio que el compilador vsct.exe .

  3. En el símbolo del sistema de Visual Studio, vaya al directorio que contiene los archivos .cto y .ctsym .

  4. Tipo

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

    donde <ctofilename> es el nombre del archivo .cto , <vsctfilename> es el nombre del archivo .vsct que desea crear y <symfilename> es el nombre del archivo .ctsym .

    Este proceso crea un nuevo archivo del compilador de tabla de comandos XML .vsct . Puede editar y compilar el archivo con vsct.exe, el compilador de vsct, como lo haría con cualquier otro archivo .vsct .

Compilar el código

Simplemente agregar un archivo .vsct a un proyecto no hace que se compile. Debe incorporarlo en el proceso de compilación.

Para agregar un archivo .vsct a la compilación del proyecto

  1. Abra el archivo del proyecto en el editor. Si el proyecto se carga, primero debe descargarlo.

  2. Agregue un elemento ItemGroup que contenga un VSCTCompile elemento , como se muestra en el ejemplo siguiente.

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

    El ResourceName elemento siempre debe establecerse Menus.ctmenuen .

  3. Si el proyecto contiene un archivo .resx , agregue un EmbeddedResource elemento que contenga un MergeWithCTO elemento, como se muestra en el ejemplo siguiente:

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

    Este marcado debe ir dentro del ItemGroup elemento que contiene recursos incrustados.

  4. Abra el archivo de paquete, normalmente denominado <ProjectName>Package.cs o< ProjectName>Package.vb, en el editor.

  5. Agregue un ProvideMenuResource atributo a la clase de paquete, como se muestra en el ejemplo siguiente.

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

    El primer valor de parámetro debe coincidir con el valor del ResourceName atributo que definió en el archivo de proyecto.

Contenido relacionado