كيفية القيام بما يلي: تخزين مصدر بيانات مؤقـتًا بطريقة برمجية في مستند Office

ينطبق على
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع مشروعات على مستوى المستند إصدار Microsoft Office Excel 2007 و Excel 2010 Word 2007 و Word 2010

يمكنك برمجيًا إضافة كائن بيانات إلى ذاكرة تخزين البيانات المؤقت في مستند ما عن طريق استدعاء الأسلوب StartCaching للعنصر المضيف، مثل Document، أو Workbook، أو Worksheet. قم بإزالة كائن بيانات من ذاكرة تخزين البيانات المؤقت باستدعاء الأسلوب StopCaching للعنصر المضيف.

الأسلوب StartCaching والأسلوب StopCaching كل منهما خاص، إلا أنهما يظهران في التحسس الذكي (IntelliSense).

عند استخدام الأسلوب StartCaching لإضافة كائن بيانات إلى ذاكرة تخزين البيانات المؤقتة، كائن البيانات لا يحتاج إلى أن يتم التصريح به بالسمة CachedAttribute. ومع ذلك، يجب أن يحقق كائن البيانات متطلبات معينة لكي يتم إضافته إلى ذاكرة تخزين البيانات المؤقت. لمزيد من المعلومات، راجع التخزين المؤقت للبيانات.

لتخزين كائن بيانات مؤقـتًا بطريقة برمجية

1. قم بالتصريح بكائن بيانات على مستوى الفئة، و ليس داخل أسلوب. يفترض هذا المثال أنك تقوم بالتصريح بـ DataSet يسمى dataSet1 و تريد تخزينه بشكل مؤقـت برمجياً.

   Public dataSet1 As DataSet
   

   public DataSet dataSet1;
   

2. قم بإنشاء مثيل لكائن البيانات، ثم قم باستدعاء الأسلوب StartCaching من المستند أو مثيل ورقة العمل ثم قم بتمرير اسم كائن البيانات.

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

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

لإيقاف تخزين كائن بيانات مؤقـتًا

• قم باستدعاء الأسلوب StopCaching من المستند أو مثيل ورقة العمل ثم قم بتمرير اسم كائن البيانات. يفترض هذا المثال أن عندك DataSet باسم dataSet1 ترغب في إيقاف تخزينه المؤقت.

  If (Me.IsCached("dataSet1")) Then
      Me.StopCaching("dataSet1")
  End If
  

  if (this.IsCached("dataSet1"))
  {
      this.StopCaching("dataSet1");
  }
  

  ملاحظة

  لا تقم باستدعاء StopCaching من معالج الأحداث للحدث Shutdown من مستند أو ورقة العمل. حينما يُرفع الحدث Shutdown، يكون من المتأخر جدا تعديل ذاكرة تخزين البيانات المؤقتة. لمزيد من المعلومات حول الحدث Shutdown، راجع الأحداث في مشاريع Office.

راجع أيضًا:

المهام

كيفية القيام بما يلي: تخزين البيانات مؤقتًا للاستخدام دون اتصال أو على خادم

كيفية القيام بما يلي: تخزين البيانات مؤقـتًا في مستند محمي بكلمة مرور

المبادئ

التخزين المؤقت للبيانات

الوصول إلى البيانات في المستندات على الخادم

موارد أخرى

حفظ بيانات

عنصر تحكم التوافق الأمثل في ADO.NET