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 par programmation un objet de données dans le 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. Supprimer 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 la StartCaching méthode pour ajouter un objet de données dans le cache de données, l’objet de données n’a pas besoin d’ê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 respecter certaines exigences pour être ajouté 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 Caching Data.For more information, see Caching Data.

Pour mettre en cache par programmation 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 du document ou feuille de calcul et passez-lui 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 du document ou feuille de calcul et passez-lui 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énements 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énements, consultez événements dans les projets Office.For more information about the Shutdown event, see Events in Office Projects.

Voir aussiSee Also

Mise en cache de données Caching Data
Comment : mettre en Cache des 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 mot de passe How to: Cache Data in a Password-Protected Document
L’accès aux données dans des Documents sur le serveur Accessing Data in Documents on the Server
Enregistrer des donnéesSaving Data