Cómo: Crear un complemento

Los complementos de Visual Studio están desusados en Visual Studio 2013. Debe actualizar los complementos a las extensiones de VSPackage. Para obtener más información sobre la actualización, vea Preguntas más frecuentes: Convertir complementos en extensiones de VSPackage.

Un complemento es un archivo DLL compilado que se ejecuta dentro del entorno de desarrollo integrado (IDE) de Visual Studio. El compilado protege la propiedad intelectual y mejora el rendimiento. A pesar de que los complementos se pueden crear manualmente, es posible que resulte más sencillo utilizar el Asistente para complementos. Este asistente crea un complemento funcional, aunque básico, que se puede ejecutar inmediatamente después de haberlo creado. Una vez que el Asistente para complementos genere el marco de trabajo sencillo, puede agregar código al marco de trabajo y personalizarlo.

El Asistente para complementos le permite proporcionar un nombre para mostrar y una descripción para su complemento. Ambos aparecerán en el Administrador de complementos. Además, puede dejar que el asistente genere código que agrega al menú Herramientas un comando para abrir el complemento. También puede optar por mostrar un cuadro Acerca de personalizado para el complemento. Cuando se complete el asistente, aparecerá un proyecto nuevo con una sola clase denominada Connect, la cual implementa el complemento.

Para crear un complemento con el Asistente para complementos

1. Cree un proyecto de complemento de Visual Studio. En el menú Archivo, elija Nuevo y haga clic en Proyecto. Vaya a Extensibilidad en el nodo Otros tipos de proyectos. Al crear el proyecto, se inicia el Asistente para complementos.

2. En la página Seleccione un lenguaje de programación, seleccione el lenguaje de programación que desee utilizar para escribir el complemento.

3. Seleccione una o más aplicaciones, como Visual Studio, en la página Seleccione una aplicación host.

   De esta forma, podrá elegir las aplicaciones en las que desee ejecutar el complemento una vez se haya creado.

4. Especifique un nombre y una descripción del complemento en la página Especifique un nombre y una descripción.

   Nota

   Dado que el carácter del punto (".") tiene un significado especial en los comandos de Visual Studio, Visual Studio no creará un comando de menú Herramientas predeterminado si el nombre del complemento contiene un punto. 

   Una vez creado el complemento, su nombre y descripción se muestran en la lista Complementos disponibles del Administrador de complementos. Agregue bastantes detalles a la descripción del complemento para que los usuarios sepan lo que hace el complemento, cómo funciona, etc.

5. En la página Elegir opciones de complemento, puede especificar:

   • Si desea que el complemento aparezca en el menú Herramientas.

   • Cuándo desea que se inicie el complemento.

   • Si el complemento utiliza una interfaz de usuario modal (UI) o no. Si no la utiliza, se puede utilizar sin ningún riesgo con compilaciones de línea de comandos.

6. En la página Elección de información para Ayuda - Acerca de, especifique si desea que la información del complemento se muestre en el cuadro de diálogo Acerca de de Visual Studio. Si es así, agregue la información que desea mostrar.

   La información que se puede agregar al cuadro de diálogo Acerca de de Visual Studio incluye número de versión, detalles de compatibilidad, datos de la licencia, etc.

7. Después de completar los pasos del 1 al 6, las opciones que seleccionó se muestran en la página Resumen para que las compruebe. Si está de acuerdo, haga clic en Finalizar para crear el complemento. Si desea cambiar algo, haga clic en el botón Atrás.

   Ya tiene un complemento funcional y básico. Para que el complemento haga lo que tiene previsto, debe agregar el código adecuado. Para obtener más información, vea Ampliar el entorno de Visual Studio.

   Para obtener información acerca de qué hace el Asistente para complementos en segundo plano, puede examinar el código que crea.

Seguridad

Los complementos administrados se registran como archivos .addin, los cuales se escriben en XML. El Asistente para complementos de Visual Studio .NET 2002 y Visual Studio .NET 2003 tiene una casilla que le permite registrar el complemento para todos los usuarios. El Asistente para complementos de Visual Studio 2005 y de versiones posteriores no tiene esa casilla. Para registrar un complemento administrado para todos los usuarios en Visual Studio 2005 y versiones posteriores, copie el archivo .addin en la carpeta ..\Documents and Settings\All Users\. Para registrar un complemento no administrado para todos los usuarios en Visual Studio 2005 y versiones posteriores, cambie HKEY_CURRENT_USER a HKEY_CLASSES_ROOT en las entradas del Registro pertinentes del archivo .reg y, a continuación, aplique este archivo al Registro. Para obtener más información, vea Procedimientos recomendados sobre seguridad en la automatización y Seguridad de complementos. El Asistente para complementos y los ensamblados de automatización no están disponibles en las ediciones de Visual Studio Express.

No es necesario usar complementos ni asistentes para tener acceso a la funcionalidad de automatización. En su lugar, puede agregar referencias a los ensamblados de automatización que desee en cualquier proyecto de Visual Studio y, posteriormente, obtener acceso a sus tipos y miembros. Sin embargo, si se utiliza la automatización en un complemento, podrá exponer en el IDE cualquier herramienta de complemento que cree.

Vea también

Tareas

Cómo: Controlar complementos con el Administrador de complementos

Cómo: Crear complementos de soluciones

Tutorial: Crear un asistente

Conceptos

Registro de complementos

Gráfico del modelo de objetos de automatización

Otros recursos

Crear complementos y asistentes