Cómo: Publicar fragmentos de código
Para que un fragmento de código aparezca en el editor de código del equipo de un usuario, se debe instalar en el PC e importarlo en Visual Studio mediante el administrador de fragmentos de código. Para facilitar este proceso, puede colocar el archivo de fragmento de código en un archivo de Visual Studio Installer (.vsi), que un usuario puede colocar en la ubicación correcta mediante el Instalador de contenido de Visual Studio. El archivo .vsi se puede compartir a continuación con facilidad con otros desarrolladores de la comunidad.
Archivos .VSI
Los archivos .vsi se usan para intercambiar contenido de Visual Studio en la comunidad de desarrolladores. Un archivo .vsi simplemente es un archivo .zip, pero debe cambiarse su nombre con la extensión de nombre de archivo .vsi para que el Instalador de contenido de Visual Studio sepa cómo controlarlo. Los archivos .vsi contienen lo siguiente:
Un archivo .vscontent que contiene código XML que describe el contenido del archivo .vsi y sigue un esquema XML concreto. Para ver una definición completa del esquema de los archivos .vscontent, consulte Cómo: Empaquetar componentes para usar el instalador de contenido de Visual Studio.
Archivos de contenido, por ejemplo, un archivo .snippet. Para obtener información acerca de cómo crear archivos .snippet, consulte Cómo: Crear un fragmento de código básico.
El Instalador de contenido de Visual Studio utiliza archivos .vsi para instalar contenido compartido en la ubicación correcta. Para obtener más información sobre cómo instalar archivos .vsi, consulte Cómo: Buscar e instalar componentes de la comunidad.
Debe establecer valores y atributos específicos en el archivo .vscontent para que el Instalador de contenido de Visual Studio sepa cómo y dónde instalar los archivos de contenido. Por ejemplo, en el archivo .vscontent de un fragmento de código, debe hacer lo siguiente:
Establecer el valor del elemento FileContentType en Code Snippet.
Agregar un elemento Attribute que tenga el atributo siguiente:
- lang: especifica el lenguaje del fragmento de código, csharp, vb, SQL, JScript, HTML o xml.
Para crear un archivo .vsi de fragmentos de código
Cree un archivo .vscontent válido para el contenido. Para obtener más información acerca del esquema de archivo .vscontent, consulte Cómo: Empaquetar componentes para usar el instalador de contenido de Visual Studio.
Seleccione los archivos que desee incluir en el archivo .vsi (incluido el archivo .vscontent), haga clic con el botón secundario en la selección, seleccione Enviar a y haga clic en Carpeta comprimida (en zip). Los archivos seleccionados se comprimen en un único archivo .zip.
Cambie la extensión del nombre de archivo .zip a .vsi.
Nota
Para mostrar la información del editor del fragmento de código en el Instalador de contenido de Visual Studio, deberá firmar el archivo .vsi. Para obtener más información, póngase en contacto con el proveedor del certificado digital.
Ejemplo
En el ejemplo siguiente se muestra un archivo .vscontent para un archivo .vsi que contiene un fragmento de código. En el ejemplo se usa para ContentVersion el valor 2.0. Si un fragmento de código es específico de Visual Studio 2008 o versiones posteriores, use el valor 2.0. Si también puede ser utilizado por Visual Studio 2005, utilice un valor de 1.0. Este archivo .vsi incluiría los siguientes archivos:
Archivo .vscontent que tiene el código de este ejemplo.
El fragmento de código MyCodeSnippet.snippet.
<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
<Content>
<FileName>MyCodeSnippet.snippet</FileName>
<DisplayName>Sample Code Snippet</DisplayName>
<Description>A code snippet created for this example</Description>
<FileContentType>Code Snippet</FileContentType>
<ContentVersion>2.0</ContentVersion>
<Attributes>
<Attribute name="lang" value="vb"/>
</Attributes>
</Content>
</VSContent>
Vea también
Tareas
Cómo: Empaquetar componentes para usar el instalador de contenido de Visual Studio