Cómo: Almacenar datos en la memoria caché para el uso sin conexión o en un servidor
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
Versión de Microsoft Office
Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto. |
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.
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é.
.gif "Nota") 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 Clientes, el nombre del objeto CachedDataItem será _Clientes en la memoria caché. Cuando utiliza ServerDocument para obtener acceso a este elemento almacenado en memoria caché, tendrá que especificar _Clientes en lugar de Clientes. |
Para almacenar datos en memoria caché en el documento mediante código
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.
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;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
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.
Si aún no tiene ninguna, cree una instancia del conjunto de datos y selecciónela en el diseñador.
En la ventana Propiedades, establezca la propiedad CacheInDocument en True.
Para obtener más información, vea Propiedades en proyectos de Visual Studio Tools para Office.
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: Dejar de almacenar en caché un origen de datos mediante programación
Cómo: Almacenar datos en caché en un documento protegido por contraseña
Conceptos
Acceso a datos de documentos en el servidor