Cómo: Crear un complemento
Actualización: noviembre 2007
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.
Para obtener información adicional acerca de |
Vea |
|---|---|
Diferencias entre los complementos de Visual Studio y los complementos compartidos. |
|
Complementos basados en soluciones. |
.gif)
.gif "Nota") Nota: |
|---|
El Asistente para complementos y los ensamblados de automatización no están disponibles en las ediciones de Visual Studio Express. |
El Asistente para complementos le permite proporcionar un nombre para mostrar y una descripción para su complemento. Ambos aparecerán en el cuadro de diálogo Administrador de complementos. Además, tiene la opción de 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 personalizado Acerca de para el complemento. Cuando se complete el asistente, aparecerá un proyecto nuevo con una clase única denominada Connect, la cual implementa el complemento.
| Nota: |
|---|
Los complementos creados en Visual Studio 2005 no funcionan en Visual Studio .NET 2003. Es posible que los complementos creados en Visual Studio .NET 2003 no funcionen correctamente en Visual Studio 2005 si no se migran primero. Para obtener más información, vea Migrar y actualizar los complementos de Visual Studio 2005 a Visual Studio 2008. |
Para tener acceso a la automatización sin crear un complemento, puede utilizar una macro. Las macros proporcionan un acceso rápido y fácil a los distintos modelos de automatización en Visual Studio. Para obtener más información, vea Espectro de automatización de Visual Studio y Automatizar acciones repetitivas mediante macros.
No es necesario utilizar complementos, asistentes ni macros 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 una macro o complemento, podrá exponer en el IDE cualquier herramienta de complemento que cree.
Este ejemplo muestra cómo crear un complemento de solución.
| Nota: |
|---|
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de la configuración activa o la edición. Estos procedimientos se desarrollaron con la Configuración general de desarrollo activa. Para cambiar la configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio. |
Para crear un complemento con el Asistente para complementos
Cree un nuevo 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.
En la página Seleccione un lenguaje de programación, seleccione el lenguaje de programación que desee utilizar para escribir el complemento.
Elija 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, por ejemplo, Visual Studio o el IDE de macros de Visual Studio.
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 punto (".") tiene un significado especial en los comandos de Visual Studio, Visual Studio no crearán 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 en el cuadro de diálogo 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.
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.
En la página Selección de información para Ayuda - Acerca de, especifique si desea que la información del complemento se muestre en la ventana Ayuda - Acerca de de Visual Studio. Si es así, agregue la información que desea mostrar.
La información que se puede agregar a la ventana Ayuda - Acerca de de Visual Studio incluye número de versión, detalles de compatibilidad, datos de la licencia, etc.
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 en Visual Studio 2005 y versiones posteriores no tiene esa casilla. Para registrar un complemento administrado para todos los usuarios en Visual Studio 2005, copie el archivo XML .Addin en la carpeta \Documents and Settings\All Users\. Para registrar un complemento no administrado para todos los usuarios en Visual Studio 2005, cambie HKEY_CURRENT_USER a HKEY_CLASSES_ROOT en las entradas del Registro en el 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.
Vea también
Tareas
Cómo: Controlar complementos con el Administrador de complementos
Conceptos
Gráfico del modelo de objetos de automatización