Compartir a través de


Información general acerca del control de almacenamiento del motor en tiempo de ejecución

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

  • Proyectos de nivel de documento

Versión de Microsoft Office

  • Microsoft Office 2003

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

El Control de almacenamiento en tiempo de ejecución es un control ActiveX incrustado en un documento o libro que forma parte de una personalización de nivel de documento para Microsoft Office 2003. El Control de almacenamiento en tiempo de ejecución contiene la siguiente información que requiere el motor en tiempo de ejecución de Visual Studio Tools para Office para ejecutar la personalización:

  • El manifiesto de aplicación.

  • Cero o varios objetos de datos almacenados en memoria caché.

El Control de almacenamiento en tiempo de ejecución se incrusta en el documento al generar el proyecto. No está visible en el documento en tiempo de ejecución.

Nota:

Las personalizaciones de nivel de documento para Microsoft Office System 2007 no utilizan el Control de almacenamiento en tiempo de ejecución. En su lugar, el motor en tiempo de ejecución de Visual Studio Tools para Office almacena información como elementos XML personalizados que se incrustan en los documentos.

Manifiesto de aplicación

El manifiesto de aplicación contiene la información necesaria para ejecutar las extensiones de código administrado. El manifiesto de aplicación señala o a un manifiesto de implementación situado en el servidor, que contiene la ubicación más reciente del ensamblado, o señala directamente al ensamblado de personalización. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office.

Datos almacenados en caché

Es posible almacenar en caché un objeto de datos del documento utilizando el atributo CachedAttribute al declarar el objeto. El almacenamiento en caché reduce el número de acciones de ida y vuelta en el servidor y hace posible la interacción con los datos sin conexión. Para obtener más información, vea Información general sobre los datos en personalizaciones de nivel de documento y Almacenar datos en caché.

Eliminar o copiar el Control de almacenamiento en tiempo de ejecución

Los usuarios finales pueden eliminar o copiar el Control de almacenamiento en tiempo de ejecución. En los siguientes ejemplos se muestra cómo la versión en tiempo de ejecución de Visual Studio Tools para Office puede detectar y corregir estas situaciones.

El usuario final ejecuta el comando Seleccionar todo y presiona Eliminar

Se elimina el Control de almacenamiento en tiempo de ejecución. Sin embargo, el control realiza una llamada a la versión en tiempo de ejecución de Visual Studio Tools para Office con la información que está a punto de eliminarse. El proceso en tiempo de ejecución agrega una nueva instancia del control al documento, enlaza con el nuevo receptor de eventos y proporciona la información guardada.

El usuario final ejecuta el comando Seleccionar todo y, a continuación, copia y pega en el mismo documento

Ahora hay dos Controles de almacenamiento en tiempo de ejecución. Sin embargo, el proceso en tiempo de ejecución comprueba si hay varias instancias del control. Si las detecta, elimina las instancias adicionales.

El usuario final ejecuta el comando Seleccionar todo y, a continuación, copia y pega en un documento distinto que tiene extensiones de código administrado

Hay dos Controles de almacenamiento en tiempo de ejecución que pretenden contener la información principal almacenada del documento. Sin embargo, se crea un identificador único global (GUID) para el control al incrustarlo en el documento en tiempo de diseño. Este GUID también se incrusta en la propiedad personalizada del documento _AssemblyLocation. Cualquier otro Control de almacenamiento en tiempo de ejecución incluido en el documento debe tener también este mismo identificador GUID. Si se encuentra cualquier Control de almacenamiento en tiempo de ejecución adicional en tiempo de carga, éste se eliminará del documento si el identificador GUID no coincide con el almacenado en el documento.

El usuario final ejecuta el comando Seleccionar todo y, a continuación, copia y pega en un documento nuevo en blanco

Ahora hay un nuevo documento con control de almacenamiento en tiempo de ejecución sin utilizar. Sin las personalizaciones adecuadas en el documento, el control no hace nada. Sin embargo, sigue ocupando espacio en el documento.

Vea también

Conceptos

Acceso a datos de documentos en el servidor

Almacenar datos en caché

Referencia

Manifiestos de aplicación para soluciones de Office (2003 System)

Otros recursos

Arquitectura de las soluciones de Visual Studio Tools para Office