Compartir a través de

Almacenar datos en la memoria caché para uso sin conexión o en un servidor

  • Artículo

Puede marcar un elemento de datos que se almacenará en caché en el documento para que esté disponible sin conexión. Esto también permite manipular los datos del documento cuando el documento se almacena en un servidor.

Aplicación: la información de este tema se aplica a los proyectos de nivel de documento de Excel y Word. Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto de Office.

Puede marcar un elemento de datos que se almacenará en caché cuando el elemento de datos se declare en el código o, si usa un DataSet, configurando una propiedad en la ventana Propiedades. Si va a almacenar en caché un elemento de datos que no es un DataSet o DataTable, compruebe que cumple los criterios para almacenarse en caché en el documento. Para obtener más información, consulta Datos de caché.

Nota:

Los conjuntos de datos creados con Visual Basic marcados como Cached y WithEvents ( (incluidos los conjuntos de datos que se arrastran de la ventana Orígenes de datos o Cuadro de herramientas que tienen la propiedad CacheInDocument como True) tienen una barra baja al principio de sus nombres en la memoria caché. Por ejemplo, si crea un conjunto de datos y le asigna el nombre Clientes, el CachedDataItem nombre será _Clientes en la memoria caché. Cuando se usa ServerDocument para acceder a este elemento almacenado en caché, debe indicar _Customers en lugar de Clientes.

Cómo almacenar en caché los datos del documento mediante código

  1. Declare un campo público o una propiedad para el elemento de datos como miembro de una clase de elemento host en el proyecto, como la clase ThisDocument de un proyecto de Word o la clase ThisWorkbook de un proyecto de Excel.

  2. Aplique el atributo CachedAttribute al miembro para marcar el elemento de datos que se almacenará en la caché de datos del documento. En el ejemplo siguiente se aplica este atributo en la declaración de un campo para un DataSet.

    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
public DataSet employeesDataSet;

  3. Agregue código para crear una instancia del elemento de datos y, si procede, para cargarlo de la base de datos.

    El elemento de datos solo se carga cuando se crea por primera vez; después, la memoria caché permanece con el documento y debe escribir otro código para actualizarlo.

Cómo almacenar en caché un conjunto de datos en el documento en el ventana Propiedades

  1. Agregue el conjunto de datos al proyecto mediante las herramientas del diseñador de Visual Studio, por ejemplo, agregando un origen de datos al proyecto en la ventana Orígenes de datos.

  2. Cree una instancia del conjunto de datos si aún no tiene una y seleccione la instancia en el diseñador.

  3. En la ventana Propiedades, pase la propiedad CacheInDocument a True.

    Para obtener más información, consulte Propiedades en proyectos de Office.

  4. En la ventana Propiedades, cambie la propiedad Modifiers a Public (la opción predeterminada es Internal).

Contenido relacionado