Verileri çevrimdışı veya sunucuda kullanmak üzere önbelleğe alma

Bir veri öğesini belgede önbelleğe alınacak şekilde işaretleyebilir, böylece çevrimdışı kullanılabilir. Bu, belge bir sunucuda depolandığında belgedeki verilerin diğer kodlar tarafından yönlendirilmesine de olanak sağlar.

Şunlar için geçerlidir: Bu konudaki bilgiler Excel ve Word için belge düzeyi projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Veri öğesi kodunuzda bildirildiğinde veya kullanıyorsanızDataSet, Özellikler penceresinde bir özellik ayarlayarak bir veri öğesini önbelleğe alınacak şekilde işaretleyebilirsiniz. veya DataTableolmayan DataSet bir veri öğesini önbelleğe alırsanız, öğenin belgede önbelleğe alınma ölçütlerini karşıladığından emin olun. Daha fazla bilgi için bkz . Verileri önbelleğe alma.

Not

Önbelleğe Alınmış ve WithEvents olarak işaretlenmiş Visual Basic kullanılarak oluşturulan veri kümelerinin (Veri Kaynakları penceresinden sürüklenen veri kümeleri veya CacheInDocument özelliğinin True olarak ayarlandığı Araç Kutusu dahil) önbellekteki adlarına bir alt çizgi ön eki vardır. Örneğin, bir veri kümesi oluşturur ve bunu Müşteriler olarak adlandırırsanız, CachedDataItem ad önbellekte _Customers . Bu önbelleğe alınmış öğeye erişmek için kullandığınızdaServerDocument, Müşteriler yerine _Customers belirtmeniz gerekir.

Kod kullanarak belgedeki verileri önbelleğe almak için

  1. Veri öğesi için word projesindeki t sınıfı veya Excel projesindeki sınıf gibi, projenizdeki bir konak öğesi sınıfının üyesi olarak ThisDocumenbir ortak alan veya ThisWorkbook özellik bildirin.

  2. Belgenin CachedAttribute veri önbelleğinde depolanacak veri öğesini işaretlemek için üyeye özniteliğini uygulayın. Aşağıdaki örnek, bu özniteliği için bir alan bildirimine DataSetuygular.

    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
    public DataSet employeesDataSet;
    
  3. Veri öğesinin bir örneğini oluşturmak ve varsa veritabanından yüklemek için kod ekleyin.

    Veri öğesi yalnızca ilk oluşturulduğunda yüklenir; bundan sonra önbellek belgeyle birlikte kalır ve bunu güncelleştirmek için başka kod yazmanız gerekir.

Özellikler penceresi kullanarak belgedeki bir veri kümesini önbelleğe almak için

  1. Veri Kaynakları penceresini kullanarak projenize bir veri kaynağı ekleyerek visual studio tasarımcısındaki araçları kullanarak veri kümesini projeye ekleyin.

  2. Henüz bir veri kümeniz yoksa veri kümesinin bir örneğini oluşturun ve tasarımcıda örneği seçin.

  3. Özellikler penceresinde CacheInDocument özelliğini True olarak ayarlayın.

    Daha fazla bilgi için bkz . Office Projelerindeki Özellikler.

  4. Özellikler penceresinde Değiştiriciler özelliğini Genel olarak ayarlayın (varsayılan olarak İç'tir).