Comment : mettre en cache par programmation une source de données dans un document OfficeHow to: Programmatically cache a data source in an Office document

Vous pouvez ajouter un objet de données par programmation au cache de données dans un document en appelant le StartCaching élément de la méthode d’un ordinateur hôte, tel qu’un Document, Workbook, ou Worksheet.You can programmatically add a data object to the data cache in a document by calling the StartCaching method of a host item, such as a Document, Workbook, or Worksheet. Suppression d’un objet de données à partir du cache de données en appelant le StopCaching méthode d’un élément hôte.Remove a data object from the data cache by calling the StopCaching method of a host item.

Le StartCaching (méthode) et le StopCaching sont privées, mais ils apparaissent dans IntelliSense.The StartCaching method and the StopCaching method are both private, but they appear in IntelliSense.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Excel et Word.Applies to: The information in this topic applies to document-level projects for Excel and Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Lorsque vous utilisez le StartCaching méthode pour ajouter un objet de données au cache de données, l’objet de données ne doit pas être déclaré avec le CachedAttribute attribut.When you use the StartCaching method to add a data object to the data cache, the data object does not need to be declared with the CachedAttribute attribute. Toutefois, l’objet de données doit remplir certaines conditions à ajouter au cache de données.However, the data object must meet certain requirements to be added to the data cache. Pour plus d’informations, consultez mettre en Cache données.For more information, see Cache data.

Pour mettre en cache par programme un objet de donnéesTo programmatically cache a data object

  1. Déclarez l’objet de données au niveau de la classe, mais pas à l’intérieur d’une méthode.Declare the data object at the class level, not inside a method. Cet exemple suppose que vous déclarez un DataSet nommé dataSet1 que vous souhaitez mettre en cache par programmation.This example assumes that you are declaring a DataSet named dataSet1 that you want to cache programmatically.

    public DataSet dataSet1;
    
    Public dataSet1 As DataSet
    
  2. Instanciez l’objet de données, puis appelez le StartCaching méthode de l’instance de document ou feuille de calcul et transmettez le nom de l’objet de données.Instantiate the data object, and then call the StartCaching method of the document or worksheet instance and pass in the name of the data object.

    dataSet1 = new DataSet();
    
    if (!this.IsCached("dataSet1"))
    {
        this.StartCaching("dataSet1");
    }
    
    dataSet1 = New DataSet()
    
    If Not (Me.IsCached("dataSet1")) Then
        Me.StartCaching("dataSet1")
    End If
    

Pour arrêter la mise en cache un objet de donnéesTo stop caching a data object

  1. Appelez le StopCaching méthode de l’instance de document ou feuille de calcul et transmettez le nom de l’objet de données.Call the StopCaching method of the document or worksheet instance and pass in the name of the data object. Cet exemple suppose que vous avez un DataSet nommé dataSet1 que vous souhaitez arrêter la mise en cache.This example assumes that you have a DataSet named dataSet1 that you want to stop caching.

    if (this.IsCached("dataSet1"))
    {
        this.StopCaching("dataSet1");
    }
    
    If (Me.IsCached("dataSet1")) Then
        Me.StopCaching("dataSet1")
    End If
    

    Note

    N’appelez pas StopCaching du Gestionnaire d’événements pour le Shutdown événement d’un document ou une feuille de calcul.Do not call StopCaching from the event handler for the Shutdown event of a document or worksheet. Au moment où le Shutdown événement est déclenché, il est trop tard pour modifier le cache de données.By the time the Shutdown event is raised, it is too late to modify the data cache. Pour plus d’informations sur la Shutdown événement, consultez Events in Office Projects.For more information about the Shutdown event, see Events in Office Projects.

Voir aussiSee also

Données du cache Cache data
Comment : mettre en Cache les données pour une utilisation hors connexion ou sur un serveur How to: Cache data for use offline or on a server
Comment : mettre en Cache les données dans un document protégé par un mot de passe How to: Cache data in a password-protected document
Accéder aux données dans des documents sur le serveur Access data in documents on the server
Enregistrer des donnéesSave data