Entradas del Registro de complementos de nivel de aplicación

Artículo
02/19/2013

Cuando implemente complementos creados con Visual Studio 2012, 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 de Microsoft Office 2013 y Microsoft Office 2010. 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 utiliza Windows Installer para implementar el complemento, debe configurar el proyecto de InstallShield Limited edition 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.

Registrar Agregar- INS para el usuario actual VS. Todos 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 2012 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 y Microsoft Office 2013 pueden cargar agregar- INS registrados en HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER.

Para cargar agregar- INS registrados en HKEY_LOCAL_MACHINE, los equipos deben tener actualización 976477 instalada.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 Implementar una solución de Office mediante ClickOnce 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	Requerido.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	Requerido.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	Requerido.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	Requerido.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 utiliza Windows Installer para implementar la solución, debe agregar el prefijo file:/// a la ruta de manifiesto.También debe anexar la cadena \|vstolocal (es decir, el carácter de canalización\|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. 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 Runtime 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 de Warmup a 1, y utilizarla junto con la entrada de LoadBehavior para reducir el tiempo de carga para Outlook 2010 y Outlook 2013 agregar- INS que se implementan 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 utiliza Windows Installer para implementar el complemento, debe configurar el proyecto de InstallShield Limited edition 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.