Cómo: crear una. Archivo de VsctHow to: Create a .Vsct File

Hay varias maneras de crear un archivo de configuración (.vsct) basado en XML Visual Studio comando tabla.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 Visual StudioVisual Studio plantilla de paquete.You can create a new VSPackage in the Visual StudioVisual Studio Package Template.

  • Puede usar el compilador de configuración de tabla de comandos basado en XML, Vsct.exe, para generar un archivo de un archivo .ctc existente.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 archivo .vsct a partir de un archivo .cto existente.You can use Vsct.exe to generate a .vsct file from an existing .cto file.

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

    Este tema explica cómo crear manualmente un nuevo archivo de vsct.This topic 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 Visual StudioVisual Studio.Start Visual StudioVisual 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 abiertos.In the Templates pane, click XML File and then click Open.

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

  5. En el propiedades ventana, haga clic en el botón Examinar (...) en la propiedad de esquemas.In the Properties window, click the Browse (...) button on the Schemas property.

  6. En la lista de esquemas XSD, seleccione el esquema de vsct.xsd.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 la tecla TAB.In the XML file, type <CommandTable and then press TAB. Cerrar la etiqueta escribiendo >.Close the tag by typing >.

    Esto crea un archivo .vsct básica.This creates a basic .vsct file.

  8. Rellene los elementos del archivo XML que desea agregar, según la VSCT esquema.Fill in the elements of the XML file that you want to add, according to the VSCT Schema. Para obtener más información, consulte creación. Archivos VsctFor more information, see Authoring .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 archivo de vsct basado en XML de un archivo de origen de comando tabla .ctc existente.You can create an XML-based .vsct file from an existing command table .ctc source file. Al hacerlo, puede aprovechar las ventajas del nuevo basado en XML Visual StudioVisual Studio formato de compilador de tabla (VSCT) de comandos.By doing this, you can take advantage of the new XML-based Visual StudioVisual 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 normalmente se encuentra en la <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 del archivo .ctc de origen que desea 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 Visual StudioVisual Studio comando ventana del símbolo del sistema, desplácese al directorio.In the Visual StudioVisual Studio Command Prompt window, navigate to the directory.

  6. TipoType

    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.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.

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

    Nota

    Puede mejorar la legibilidad del archivo .vsct volviendo a asignar formato a 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 archivo .vsct basado en XML a partir de un archivo .cto binario existente.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 proceso funciona aunque el archivo .cto esté compilado a partir de un archivo .ctc.This process works even if the .cto file was compiled from a .ctc file. Puede editar y compilar el archivo .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 del archivo .cto y el archivo .ctsym correspondiente.Obtain copies of the .cto file and its corresponding .ctsym file.

  2. Coloque los archivos en el mismo directorio que el compilador vsct.exe.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 los archivos .cto y .ctsym.At the Visual Studio Command Prompt, go to the directory that contains the .cto and .ctsym files.

  4. Tipo de vsct.exe ctofilename *** .cto* * vsctfilename .vsct -Ssymfilename ctsym*.Type **vsct.exe ctofilename.cto vsctfilename ***.vsct -Ssymfilename.ctsym*.

    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.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 archivo compilador de tabla de comandos XML .vsct.This process creates a new .vsct XML command table compiler file. Puede editar y compilar el archivo con vsct.exe, el compilador de .vsct, tal como lo haría con cualquier otro archivo .vsct.You can edit and compile the file with vsct.exe, the vsct compiler, as you would any other .vsct file.

Compilar el códigoCompiling the Code

Basta con agregar un archivo .vsct a un proyecto no provoca que se compile.Simply adding a .vsct file to a project does not cause it to compile. Se debe incorporar 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, debe descargar primero.If the project is loaded, you must unload it first.

  2. Agregar un elemento ItemGroup que contiene un elemento VSCTCompile, tal 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 elemento ResourceName siempre debe establecerse en Menus.ctmenu.The ResourceName element should always be set to Menus.ctmenu.

  3. Si el proyecto contiene un archivo .resx, agregue un elemento de EmbeddedResource que contiene un elemento MergeWithCTO, tal 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 debería ir dentro del elemento ItemGroup que contiene recursos incrustados.This markup should go inside the ItemGroup element that contains embedded resources.

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

  5. Agregue un atributo ProvideMenuResource 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 del atributo ResourceName 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

Creación. Archivos Vsct Authoring .Vsct Files
Tabla de comandos de Visual Studio (. Archivos Vsct) Visual Studio Command Table (.Vsct) Files
Referencia del esquema XML de VSCTVSCT XML Schema Reference