nasıl yapılır: bir Office belgesinde program aracılığıyla veri kaynağını önbelleğe alma

StartCaching,, Veya gibi bir konak öğesinin yöntemini çağırarak bir belgedeki veri önbelleğine programlı bir şekilde veri nesnesi ekleyebilirsiniz Document Workbook Worksheet . Bir konak öğesinin yöntemini çağırarak veri önbelleğinden veri nesnesini kaldırın StopCaching .

StartCachingYöntemi ve StopCaching yöntemi hem özeldir, ister IntelliSense 'de görünürler.

**** Uygulama alanı:- Bu konu başlığı altındaki bilgiler, Excel ve Word için belge düzeyindeki projelere yöneliktir. Daha fazla bilgi için bkz. Office uygulaması ve proje türü tarafından kullanılabilen özellikler.

Veri StartCaching önbelleğine veri nesnesi eklemek için yöntemini kullandığınızda, veri nesnesinin özniteliğiyle birlikte bildirilmesine gerek yoktur CachedAttribute . Ancak veri nesnesi, veri önbelleğine eklenmek üzere belirli gereksinimleri karşılamalıdır. Daha fazla bilgi için bkz. önbelleği verileri.

Bir veri nesnesini programlı bir şekilde önbelleğe almak için

  1. Veri nesnesini bir yöntem içinde değil sınıf düzeyinde bildirin. Bu örnek, DataSet dataSet1 programlama yoluyla önbelleğe almak istediğiniz bir adlandırılmış adı bildirdiğinizi varsayar.

    public DataSet dataSet1;
    
    Public dataSet1 As DataSet
    
  2. Veri nesnesini oluşturun ve sonra StartCaching belge veya çalışma sayfası örneği yöntemini çağırın ve veri nesnesinin adını geçirin.

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

Veri nesnesini önbelleğe almayı durdurmak için

  1. StopCachingBelge veya çalışma sayfası örneği yöntemini çağırın ve veri nesnesinin adını geçirin. Bu örnek, DataSet önbelleğe almayı durdurmak istediğiniz bir adlandırılmış olduğunu varsayar dataSet1 .

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

    Not

    StopCaching Shutdown Bir belge veya çalışma sayfası olayı için olay işleyicisinden çağırmayın. ShutdownOlayın ortaya çıkarılışında, veri önbelleğini değiştirmek çok geç olur. olay hakkında daha fazla bilgi için Shutdown bkz. Office projelerindeki olaylar.

Ayrıca bkz.