Cómo: crear un archivo .vsctHow to: Create a .vsct file

Hay varias maneras de crear una configuración de tabla de comandos de Visual Studio basado en XML (.vsct) archivo.There are several ways to create an XML-based Visual Studio command table configuration (.vsct) file.

  • Puede crear un nuevo VSPackage se muestra en el Programa para la mejoraVisual Studio plantilla de paquete.You can create a new VSPackage in the Programa para la mejoraVisual Studio package template.

  • Puede usar el compilador de configuración de tabla de comando basado en XML, Vsct.exe, para generar un archivo a partir de una máquina .ctc archivo.You can use the XML-based command table configuration compiler, Vsct.exe, to generate a file from an existing .ctc file.

  • Puede usar Vsct.exe para generar un .vsct archivo a partir de una máquina .cto archivo.You can use Vsct.exe to generate a .vsct file from an existing .cto file.

  • Puede crear manualmente un nuevo .vsct archivo.You can manually create a new .vsct file.

    En este artículo se explica cómo crear manualmente un nuevo .vsct archivo.This article explains how to manually create a new .vsct file.

Para crear manualmente un nuevo archivo de vsctTo manually create a new .vsct file

  1. Inicie Programa para la mejoraVisual Studio.Start Programa para la mejoraVisual Studio.

  2. En el archivo menú, elija Newy, a continuación, haga clic en archivo.On the File menu, point to New, and then click File.

  3. En el plantillas panel, haga clic en archivo XML y, a continuación, haga clic en abierto.In the Templates pane, click XML File and then click Open.

  4. En el vista menú, haga clic en propiedades para mostrar las propiedades del archivo XML.On the View menu, click Properties to display the properties of the XML file.

  5. En el propiedades ventana, haga clic en el examinar situado en la esquemas propiedad.In the Properties window, click the Browse button on the Schemas property.

  6. En la lista de esquemas XSD, seleccione la vsct.xsd esquema.In the list of XSD schemas, select the vsct.xsd schema. Si no está en la lista, haga clic en agregar y, a continuación, busque el archivo en una unidad local.If it is not in the list, click Add and then find the file on a local drive. Haga clic en Aceptar cuando haya terminado.Click OK when you are finished.

  7. En el archivo XML, escriba < CommandTable y, a continuación, presione ficha. Cerrar la etiqueta escribiendo >.In the XML file, type <CommandTable and then press Tab. Close the tag by typing >.

    Esta acción crea un basic .vsct archivo.This action creates a basic .vsct file.

  8. Rellenar los elementos del archivo XML que desea agregar, de acuerdo con la referencia del esquema XML de VSCT.Fill in the elements of the XML file that you want to add, according to the VSCT XML schema reference. Para obtener más información, consulte crear archivos de vsctFor more information, see Author .vsct files

Cómo: crear un archivo .vsct a partir de un archivo .ctc existenteHow to: Create a .vsct File from an existing .ctc file

Puede crear un basado en XML .vsct archivo desde una tabla existente del comando .ctc archivo de código fuente.You can create an XML-based .vsct file from an existing command table .ctc source file. Al hacerlo, puede sacar partido del nuevo basado en XML Programa para la mejoraVisual Studio formato del compilador de comandos (VSCT) de la tabla.By doing this, you can take advantage of the new XML-based Programa para la mejoraVisual Studio command table (VSCT) compiler format.

Para crear un archivo .vsct a partir de un archivo .ctc existenteTo create a .vsct file from a .ctc file

  1. Obtenga una copia del lenguaje Perl.Obtain a copy of the Perl language.

  2. Obtenga una copia de la secuencia de comandos Perl ConvertCTCToVSCT.pl, que se encuentra normalmente en el <ruta de instalación de Visual Studio SDK > \VisualStudioIntegration\Tools\bin carpeta.Obtain a copy of the Perl script ConvertCTCToVSCT.pl, typically located in the <Visual Studio SDK installation path>\VisualStudioIntegration\Tools\bin folder.

  3. Obtenga una copia de la .ctc archivo de código fuente que se va a convertir.Obtain a copy of the .ctc source file that you want to convert.

  4. Coloque los archivos en el mismo directorio.Place the files in the same directory.

  5. En el Programa para la mejoraVisual Studio ventana del símbolo de comandos, navegue hasta el directorio.In the Programa para la mejoraVisual Studio command prompt window, navigate to the directory.

  6. TipoType

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

    donde PkgCmd.ctc es el nombre de la .ctc archivo y PkgCmd.vsct es el nombre de la .vsct archivo que desea crear.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.

    Esta acción crea un nuevo .vsct archivo de origen de tabla de comandos XML.This action creates a new .vsct XML command table source file. Puede compilar el archivo mediante el uso de Vsct.exe, el compilador VSCT, como haría con cualquier otro .vsct archivo.You can compile the file by using Vsct.exe, the VSCT compiler, as you would any other .vsct file.

    Note

    Puede mejorar la legibilidad de la .vsct archivo volviendo a formatear los comentarios XML.You can improve the readability of the .vsct file by reformatting the XML comments.

Cómo: crear un archivo .vsct a partir de un archivo .cto existenteHow to: Create a .vsct file from an existing .cto file

Puede crear un basado en XML .vsct archivo desde un binario existente .cto archivo.You can create an XML-based .vsct file from an existing binary .cto file. Si lo hace, podrá aprovechar el nuevo formato de compilador de tabla de comandos.Doing this allows you to take advantage of the new command table compiler format. Este asistente de proceso funciona aunque el .cto archivo compilado a partir de un .ctc archivo.This process works even if the .cto file was compiled from a .ctc file. Puede editar y compilar el .vsct en otro archivo .cto.You can edit and compile the .vsct file into another .cto file.

Para crear un archivo .vsct a partir de un archivo .ctoTo create a .vsct file from a .cto file

  1. Obtenga copias de los .cto archivo y su correspondiente ctsym archivo.Obtain copies of the .cto file and its corresponding .ctsym file.

  2. Coloque los archivos en el mismo directorio que el vsct.exe compilador.Place the files into the same directory as the vsct.exe compiler.

  3. En el símbolo del sistema de Visual Studio, vaya al directorio que contiene el .cto y ctsym archivos.At the Visual Studio command prompt, go to the directory that contains the .cto and .ctsym files.

  4. TipoType

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

    donde <ctofilename> es el nombre de la .cto archivo, <vsctfilename> es el nombre de la .vsct archivo que desea volver a crear y <symfilename> es el nombre de la ctsym archivo.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.

    Este proceso crea un nuevo .vsct archivo del compilador de tabla de comandos XML.This process creates a new .vsct XML command table compiler file. Puede editar y compilar el archivo con vsct.exe, el compilador vsct, como haría con cualquier otro .vsct archivo.You can edit and compile the file with vsct.exe, the vsct compiler, as you would any other .vsct file.

Compile el códigoCompile the code

Simplemente agregando un .vsct archivo a un proyecto no hace que se va a compilar.Simply adding a .vsct file to a project does not cause it to compile. Debe incorporarlo en el proceso de compilación.You must incorporate it in the build process.

Para agregar un archivo .vsct a la compilación del proyectoTo add a .vsct file to project compilation

  1. Abra el archivo de proyecto en el editor.Open your project file in the editor. Si se carga el proyecto, primero debe descargarlo.If the project is loaded, you must unload it first.

  2. Agregar un elemento ItemGroup que contiene un VSCTCompile elemento, como se muestra en el ejemplo siguiente.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>  
    

    El ResourceName elemento siempre debe establecerse en Menus.ctmenu.The ResourceName element should always be set to Menus.ctmenu.

  3. Si el proyecto contiene un .resx , agregue un EmbeddedResource elemento que contiene un MergeWithCTO elemento, como se muestra en el ejemplo siguiente: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>  
    

    Este marcado debe ir dentro el ItemGroup elemento que contiene recursos incrustados.This markup should go inside the ItemGroup element that contains embedded resources.

  4. Abra el archivo de paquete, normalmente denominado <ProjectName>Package.cs o <ProjectName>Package.vb, en el editor.Open the package file, usually named <ProjectName>Package.cs or <ProjectName>Package.vb, in the editor.

  5. Agregar un ProvideMenuResource atributo a la clase de paquete, tal como se muestra en el ejemplo siguiente.Add a ProvideMenuResource attribute to the package class, as shown in the following example.

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

    El primer valor del parámetro debe coincidir con el valor de la ResourceName atributo definido en el archivo de proyecto.The first parameter value must match the value of the ResourceName attribute you defined in the project file.

Vea tambiénSee also

Archivos .vsct de autor Author .vsct files
Archivos visuales Studio comando table (.vsct) Visual Studio command table (.vsct) files
Referencia del esquema XML de VSCTVSCT XML schema reference