Entradas del Registro de complementos de nivel de aplicación
Cuando implemente complementos creados con Visual Studio 2010, debe crear un conjunto específico de entradas del Registro. Estas entradas del Registro proporcionan información que permite a la aplicación de Microsoft Office detectar y cargar el complemento.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
Al compilar un proyecto, Visual Studio crea estas entradas del Registro en el equipo de desarrollo para poder ejecutar y depurar con facilidad el complemento. Si se usa ClickOnce para implementar el complemento, las entradas del Registro se crean automáticamente en el equipo del usuario final. Si usa Windows Installer para implementar el complemento, debe configurar el proyecto de instalación para crear las entradas del Registro en el equipo del usuario final.
Para obtener más información sobre cómo las entradas del Registro se utilizan durante el proceso de carga para complementos, vea Arquitectura de los complementos de nivel de aplicación.
Nota
En este tema, el texto identificador del complemento representa un identificador exclusivo para el complemento. De forma predeterminada, el identificador es el nombre del ensamblado de complemento.
Registro de complementos para el usuario actual frente aTodos los usuarios
Cuando se instala un complemento, este se puede registrar de dos maneras:
Solo para el usuario actual (es decir, únicamente está disponible para el usuario que se registra en el equipo cuando el complemento está instalado). En este caso, las entradas del Registro se crean bajo HKEY_CURRENT_USER.
Para todos los usuarios (es decir, cualquier usuario que inicie sesión en el equipo puede utilizar el complemento). En este caso, las entradas del Registro se crean bajo HKEY_LOCAL_MACHINE.
Todos los complementos que se crean mediante Visual Studio 2010 se pueden registrar para el usuario actual. Sin embargo, los complementos se pueden registrar para todos los usuarios en algunos escenarios. Estos escenarios dependen de la versión de Microsoft Office en el equipo y de cómo se implementó el complemento.
Versión de Microsoft Office
Las aplicaciones de Microsoft Office 2010 pueden cargar complementos registrados en HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER.
De forma predeterminada, las aplicaciones de Microsoft Office System 2007 solo pueden cargar complementos registrados en HKEY_CURRENT_USER. Para cargar los complementos registrados en HKEY_LOCAL_MACHINE, los equipos que tienen estas aplicaciones instaladas también deben tener instalada la revisión 976477. Para obtener más información, vea https://go.microsoft.com/fwlink/?LinkId=184923.
Tipo de implementación
Si se usa ClickOnce para implementar un complemento, dicho complemento sólo se puede registrar para el usuario actual. Esto se debe a que ClickOnce sólo admite la creación de claves bajo HKEY_CURRENT_USER. Si desea registrar un complemento para todos los usuarios de un equipo, debe usar Windows Installer para implementarlo. Para obtener más información sobre estos tipos de implementación, vea Publicar soluciones de Office y Implementar una solución de Office mediante Windows Installer.
Entradas del Registro
Las entradas del Registro de complementos necesarias se encuentran bajo la siguiente clave del Registro en todas las aplicaciones excepto en Visio, donde la Raíz es HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE.
Raíz\Software\Microsoft\Office\nombre de la aplicación\Addins\Id. del complemento
En Visio, las entradas del Registro se encuentran en la clave del Registro siguiente.
Raíz\Software\Microsoft\Visio\Complementos\Id. del complemento
En la tabla siguiente se enumeran las entradas bajo esta clave del Registro.
Entry |
Tipo |
Valor |
|---|---|---|
Description |
REG_SZ |
Obligatorio. Breve descripción del complemento. Esta descripción se muestra cuando el usuario selecciona el complemento en el panel Complementos del cuadro de diálogo Opciones en la aplicación de Microsoft Office. |
FriendlyName |
REG_SZ |
Obligatorio. Un nombre descriptivo del complemento que se muestra en el cuadro de diálogo Complementos COM de la aplicación de Microsoft Office. El valor predeterminado es el identificador del complemento. |
LoadBehavior |
REG_DWORD |
Obligatorio. Un valor que especifica cuándo la aplicación intenta cargar el complemento y el estado actual del complemento (cargado o no cargado). De forma predeterminada, este valor se establece en 3, lo que especifica que el complemento se carga al inicio. Para obtener más información, vea Valores de LoadBehavior. |
Manifest |
REG_SZ |
Obligatorio. La ruta de acceso completa del manifiesto de implementación del complemento. La ruta de acceso puede ser una ubicación del equipo local, un recurso compartido de red (UNC) o un servidor web (HTTP). Si usa Windows Installer para implementar la solución, anexe la cadena |vstolocal (es decir, el carácter de barra vertical |seguido de vstolocal) al final de esta ruta de acceso. Esto garantiza que la solución se carga desde la carpeta de instalación, en lugar de la memoria caché de ClickOnce. Para obtener más información, vea Implementar una solución de Office mediante Windows Installer. .gif "Nota") Nota
Cuando se compila un complemento en el equipo de desarrollo, Visual Studio anexa automáticamente la cadena |vstolocal a esta entrada del Registro.
|
Warmup |
REG_DWORD |
Opcional. Un valor que indica que .NET Framework y Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office se cargan antes de cargarse un complemento y reducen el tiempo percibido para cargar un complemento. Establezca la entrada Warmup en 1 y úsela junto con la entrada LoadBehavior a fin de reducir el tiempo de carga para los complementos de Outlook 2010 implementados mediante Windows Installer (.msi). Esta clave del Registro no se puede establecer con ClickOnce. |
Entradas del Registro para las áreas de formulario de Outlook
Si crea un área de formulario personalizada en un complemento para Outlook 2007, se utilizan entradas del Registro adicionales para registrar el área de formulario en Outlook. Estas entradas se crean bajo una clave del Registro diferente para cada clase de mensaje que admite el área del formulario. Estas claves del Registro se encuentran en la siguiente ubicación, donde la Raíz es HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE.
Raíz\Software\Microsoft\Office\Outlook\FormRegions\clase de mensaje
Como las otras entradas del Registro compartidas por todos los complementos, Visual Studio crea las entradas del Registro del área de formulario en el equipo de desarrollo al compilar su proyecto. Si se usa ClickOnce para implementar el complemento, las entradas del Registro se crean automáticamente en el equipo del usuario final. Si usa Windows Installer para implementar el complemento, debe configurar el proyecto de instalación para crear las entradas del Registro en el equipo del usuario final.
Para obtener más información sobre las entradas del Registro del área de formulario, vea Especificar áreas de formulario en el Registro de Windows. Para obtener más información sobre las áreas de formulario de Outlook, vea Crear áreas de formulario de Outlook.
Valores de LoadBehavior
La entrada LoadBehavior bajo la clave Raíz\Software\Microsoft\Office\nombre de aplicación\Addins\ID de complemento contiene una combinación de valores bit a bit que especifica el comportamiento en tiempo de ejecución del complemento. El bit de orden más bajo (valores 0 y 1) indica si el complemento se carga o descarga actualmente. Otros bits indican cuándo intenta cargar la aplicación el complemento.
Normalmente, la entrada LoadBehavior está pensada para establecerse en 0, 3 o 16 (en formato decimal) cuando el complemento se instala en equipos de usuario final. De forma predeterminada, Visual Studio establece la entrada LoadBehavior de su complemento en 3 al compilarlo o publicarlo.
En la tabla siguiente se enumeran todos los valores posibles de la entrada LoadBehavior. Algunas descripciones en esta tabla hacen referencia a cargar un complemento manualmente o mediante programación. Para cargar un complemento manualmente, active la casilla al lado del complemento en el cuadro de diálogo Complementos COM en la aplicación. Para cargar un complemento mediante programación, establezca la propiedad Connect del objeto COMAddIn que representa el complemento en true.
Valor (en formato decimal) |
Estado del complemento |
Comportamiento de carga de complementos |
Descripción |
|---|---|---|---|
0 |
Unloaded |
No cargar automáticamente |
La aplicación nunca intenta cargar el complemento automáticamente. El usuario puede intentar cargar el complemento manualmente, o se puede cargar el complemento mediante programación. Si se carga correctamente el complemento, el valor LoadBehavior sigue siendo 0, pero el estado del complemento en el cuadro de diálogo Complementos COM se actualiza para indicar que se carga el complemento. |
1 |
Loaded |
No cargar automáticamente |
La aplicación nunca intenta cargar el complemento automáticamente. El usuario puede intentar cargar el complemento manualmente, o se puede cargar el complemento mediante programación. Aunque el cuadro de diálogo Complementos COM indica que se carga el complemento después de que la aplicación se inicia, realmente no se carga el complemento hasta que se cargue manualmente o mediante programación. Si la aplicación carga correctamente el complemento, el valor de LoadBehavior cambia a 0, y sigue siendo 0 una vez se cierra la aplicación. |
2 |
Unloaded |
Cargar al inicio |
La aplicación no intenta cargar el complemento automáticamente. El usuario puede intentar cargar el complemento manualmente, o se puede cargar el complemento mediante programación. Si la aplicación carga correctamente el complemento, el valor de LoadBehavior cambia a 3, y sigue siendo 3 una vez se cierra la aplicación. |
3 |
Loaded |
Cargar al inicio |
La aplicación intenta cargar el complemento cuando se inicia la aplicación. Este es el valor predeterminado al compilar o publicar un complemento en Visual Studio. Si la aplicación carga correctamente el complemento, el valor de LoadBehavior sigue siendo 3. Si se produce un error al cargar el complemento, el valor de LoadBehavior cambia a 2, y sigue siendo 2 una vez se cierra la aplicación. |
8 |
Unloaded |
Carga a petición |
La aplicación no intenta cargar el complemento automáticamente. El usuario puede intentar cargar el complemento manualmente, o se puede cargar el complemento mediante programación. Si la aplicación carga correctamente el complemento, el valor de LoadBehavior cambia a 9. |
9 |
Loaded |
Carga a petición |
Solo se cargará el complemento cuando la aplicación lo requiere, como cuando un usuario hace clic en un elemento de la interfaz de usuario que utiliza la funcionalidad en el complemento (por ejemplo, un botón personalizado de la Cinta). Si la aplicación carga correctamente el complemento, el valor de LoadBehavior sigue siendo 9, pero el estado del complemento en el cuadro de diálogo Complementos COM se actualiza para indicar que se está cargando actualmente el complemento. Si se produce un error al cargar el complemento, el valor de LoadBehavior cambia a 8. |
16 |
Loaded |
Carga la primera vez, a continuación, carga a petición |
Establezca este valor si desea cargar su complemento a petición. La aplicación carga el complemento cuando el usuario ejecuta la aplicación por primera vez. La próxima vez que el usuario ejecute la aplicación, esta cargará todos los elementos de la interfaz de usuario definidos por el complemento, pero el complemento no se cargará hasta que el usuario haga clic en un elemento de la interfaz de usuario que esté asociado con el complemento. Cuando la aplicación carga correctamente el complemento por primera vez, el valor de LoadBehavior sigue siendo 16 mientras se carga el complemento. Después de que la aplicación se cierra, el valor LoadBehavior cambia a 9. |
Vea también
Conceptos
Arquitectura de los complementos de nivel de aplicación
Información general acerca del proceso de compilación de soluciones de Office
Otros recursos
Arquitectura de las soluciones de Office en Visual Studio
Implementar soluciones de Office
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Mayo de 2010 |
Se proporciona más contexto sobre el uso de |vstolocal en la entrada del manifiesto. |
Mejora de la información. |