Partager via


Comment : mettre en cache par programmation une source de données dans un document Office

Vous pouvez ajouter par programmation un objet de données dans le cache de données d'un document en appelant la méthode StartCaching d'un élément hôte, tel qu'un Document, Workbook ou Worksheet. Supprimez un objet de données du cache de données en appelant la méthode StopCaching d'un élément hôte.

Les méthodes StartCaching et StopCaching sont privées mais apparaissent dans IntelliSense.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour les applications suivantes : Excel 2007, Excel 2010, Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Lorsque vous utilisez la méthode StartCaching pour ajouter un objet de données dans le cache de données, il n'est pas nécessaire que l'objet de données soit déclaré avec l'attribut CachedAttribute. Toutefois, l'objet de données doit satisfaire à certaines exigences pour être ajouté au cache de données. Pour plus d'informations, consultez Mise en cache des données.

Pour mettre en cache un objet de données par programmation

  1. Déclarez l'objet de données au niveau de la classe, et non au sein d'une méthode. Cet exemple suppose que vous déclarez un DataSet nommé dataSet1 que vous souhaitez mettre en cache par programmation.

    Public dataSet1 As DataSet
    
    public DataSet dataSet1;
    
  2. Instanciez l'objet de données, puis appelez la méthode StartCaching de l'instance du document ou de la feuille de calcul et passez le nom de l'objet de données.

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

Pour arrêter la mise en cache d'un objet de données

  • Appelez la méthode StopCaching de l'instance du document ou de la feuille de calcul et passez le nom de l'objet de données. Cet exemple suppose que vous avez un DataSet nommé dataSet1 dont vous souhaitez arrêter la mise en cache.

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

    Notes

    N'appelez pas StopCaching à partir du gestionnaire d'événements pour l'événement Shutdown d'un document ou d'une feuille de calcul. Lorsque l'événement Shutdown est déclenché, il est trop tard pour modifier le cache de données. Pour plus d'informations sur l'événement Shutdown, consultez Événements dans les projets Office.

Voir aussi

Tâches

Comment : mettre en cache des données pour une utilisation hors connexion ou sur un serveur

Comment : mettre en cache des données dans un document protégé par un mot de passe

Concepts

Mise en cache des données

Accès aux données des documents sur le serveur

Autres ressources

Enregistrement des données

Concurrency Control in ADO.NET