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

Puede marcar un elemento de datos para que se almacene en memoria caché en el documento y esté así disponible sin conexión. De esta forma, también se podrán manipular los datos del documento con otro código cuando dicho documento se encuentre almacenado en un servidor.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para las siguientes aplicaciones: Excel 2007 y Excel 2010; Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Puede marcar un elemento de datos para que se almacene en memoria caché cuando dicho elemento se declara en su código o, si está utilizando un objeto DataSet, tiene que especificar la propiedad en la ventana Propiedades. Si está almacenando en memoria caché un elemento de datos que no es DataSet ni DataTable, asegúrese de que cumple los criterios para almacenarse en memoria caché en el documento. Para obtener más información, vea Almacenar datos en caché.

Nota

Los nombres de los conjuntos de datos creados mediante Visual Basic que están marcados como Cached y WithEvents (incluidos los conjuntos de datos arrastrados desde la ventana Orígenes de datos o Cuadro de herramientas cuya propiedad CacheInDocument está establecida en True) vienen precedidos por un carácter de subrayado en la memoria caché. Por ejemplo, si crea un conjunto de datos y lo denomina Customers, el nombre de CachedDataItem será _Customers en la memoria caché. Si usa ServerDocument para obtener acceso al elemento almacenado en memoria caché, deberá especificar _Customers en lugar de Customers.

Para almacenar datos en memoria caché en el documento mediante código

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

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

    <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
    Public employeesDataSet As DataSet
    
    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
    public DataSet employeesDataSet;
    
  3. Agregue código para crear una instancia del elemento de datos y, si corresponde, cargarlo desde la base de datos.

    El elemento de datos sólo se carga cuando se crea por primera vez; después de esto, la memoria caché se queda con el documento y es preciso escribir otro código para actualizarlo.

Para almacenar un conjunto de datos en la memoria caché del documento mediante la ventana Propiedades

  1. Agregue el conjunto de datos al proyecto con las herramientas del diseñador de Visual Studio; por ejemplo, puede agregar un origen de datos al proyecto a través de la ventana Orígenes de datos.

  2. Si aún no tiene ninguna, cree una instancia del conjunto de datos y selecciónela en el diseñador.

  3. En la ventana Propiedades, establezca la propiedad CacheInDocument en True.

    Para obtener más información, vea Propiedades de los proyectos de Office.

  4. En la ventana Propiedades, establezca la propiedad Modifiers en Public (el valor predeterminado es Internal).

Vea también

Tareas

Cómo: Almacenar en memoria caché un origen de datos de un documento de Office mediante programación

Cómo: Almacenar datos en caché en un documento protegido por contraseña

Conceptos

Almacenar datos en caché

Acceso a datos de documentos en el servidor

Otros recursos

Guardar datos

Control de simultaneidad en ADO.NET