Nasıl Yapılır: Veri Kaynağını Programlamayla Office Belgesinden Önbelleğe Alma

Makale
06/10/2015

Konak öğesinin StartCaching yöntemini çağırarak programlı olarak veri nesnesini belgedeki veri önbelleğine ekleyebilirsiniz, örn. Document, Workbook veya Worksheet.Konak öğesinin StopCaching yöntemini çağırarak veri nesnesini veri önbelleğinden kaldırın.

StartCaching yöntemi ve StopCaching yönteminin her ikisi de özeldir, fakat IntelliSense'de görünürler.

Uygulama hedefi: Bu konudaki bilgiler, şu uygulamalar için belge düzeyi projelere yöneliktir. Excel 2013 ve Excel 2010; Word 2013 ve Word 2010. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

Veri önbelleğine veri nesnesi eklemek için StartCaching yöntemini kullandığınızda, veri nesnesinin CachedAttribute özniteliği ile bildirilmesine gerek yoktur.Fakat, veri nesnesi veri önbelleğine eklenmesi için belli gereksinimleri karşılamalıdır.Daha fazla bilgi için bkz. Verileri Önbelleğe Alma.

Veri nesnesini programlı olarak önbelleğe almak

Veri nesnesini sınıf düzeyinde bildirin, yöntemin içinde değil. Bu örnekte programlı olarak önbelleğe almak istediğiniz dataSet1 isimli DataSet'i bildirdiğiniz varsayılır.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```

Veri nesnesini oluşturun, belge veya çalışma sayfası örneğinin StartCaching yöntemini çağırın ve onu veri nesnesinin adında geçirin.

dataSet1 = New DataSet()

If Not (Me.IsCached("dataSet1")) Then 
    Me.StartCaching("dataSet1")
End If

dataSet1 = new DataSet();

if (!this.IsCached("dataSet1"))
{
    this.StartCaching("dataSet1");
}

Veri nesnesini önbelleğe almayı durdurmak

Veri nesnesini oluşturun, belge veya çalışma sayfasının örneğinin StopCaching yöntemini çağırın ve onu veri nesnesinin adında geçirin.Bu örnekte önbelleğe alma işlemini durdurmak istediğiniz dataSet1 isimli DataSet'e sahip olduğunuz varsayılır.
```
If (Me.IsCached("dataSet1")) Then 
    Me.StopCaching("dataSet1")
End If
```
```
if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}
```
[!NOT]

Belgenin veya çalışma sayfasının Shutdown olayı için olay işleyicisinden StopCaching'i çağırmayın.Shutdown olayı oluştuğu sırada, veri önbelleğini değiştirmek için çok geçtir.Shutdown olayı hakkında daha fazla bilgi için, bkz. Office Projelerindeki Olaylar.

Ayrıca bkz.

Görevler

Nasıl Yapılır: Çevrimdışı veya Sunucuda Kullanmak Üzere Verileri Önbelleğe Alma

Nasıl Yapılır: Parola Korumalı Belgede Veriyi Önbelleğe Alma

Kavramlar

Verileri Önbelleğe Alma

Sunucudaki Belgelerde Verilere Erişme

Verileri Kaydetme

Aracılığıyla paylaş