تخزين مصدر بيانات مؤقـتًا بطريقة برمجية في مستند Office
<هذه مقاطع من مواضيع أعجبتني من مكتبة تعليمات فيجوال ستوديو 2010, أرجو أن تنال إعجابكم. المقالة الأساسية موجودة هنا >
يمكنك برمجيًا إضافة كائن بيانات إلى ذاكرة تخزين البيانات المؤقت في مستند ما عن طريق استدعاء الأسلوب StartCaching للعنصر المضيف، مثل Document، أو Workbook، أو Worksheet. قم بإزالة كائن بيانات من ذاكرة تخزين البيانات المؤقت باستدعاء الأسلوب StopCaching للعنصر المضيف.
الأسلوب StartCaching والأسلوب StopCaching كل منهما خاص، إلا أنهما يظهران في التحسس الذكي (IntelliSense).
عند استخدام الأسلوب StartCaching لإضافة كائن بيانات إلى ذاكرة تخزين البيانات المؤقتة، كائن البيانات لا يحتاج إلى أن يتم التصريح به بالسمة CachedAttribute. ومع ذلك، يجب أن يحقق كائن البيانات متطلبات معينة لكي يتم إضافته إلى ذاكرة تخزين البيانات المؤقت. لمزيد من المعلومات، راجع التخزين المؤقت للبيانات.
لتخزين كائن بيانات مؤقـتًا بطريقة برمجية
1. قم بالتصريح بكائن بيانات على مستوى الفئة، و ليس داخل أسلوب. يفترض هذا المثال أنك تقوم بالتصريح بـ DataSet يسمى dataSet1 و تريد تخزينه بشكل مؤقـت برمجياً.
Visual Basic
Public dataSet1 As DataSet
#C
public DataSet dataSet1;
2. قم بإنشاء مثيل لكائن البيانات، ثم قم باستدعاء الأسلوب StartCaching من المستند أو مثيل ورقة العمل ثم قم بتمرير اسم كائن البيانات.
Visual Basic
dataSet1 = New DataSet()
If Not (Me.IsCached("dataSet1")) Then
Me.StartCaching("dataSet1")
End If
#C
dataSet1 = new DataSet();
if (!this.IsCached("dataSet1"))
{
this.StartCaching("dataSet1");
}
لإيقاف تخزين كائن بيانات مؤقـتًا
- قم باستدعاء الأسلوب StopCaching من المستند أو مثيل ورقة العمل ثم قم بتمرير اسم كائن البيانات. يفترض هذا المثال أن عندك DataSet باسم dataSet1 ترغب في إيقاف تخزينه المؤقت.
Visual Basic
If (Me.IsCached("dataSet1")) Then
Me.StopCaching("dataSet1")
End If
#C
if (this.IsCached("dataSet1"))
{
this.StopCaching("dataSet1");
}
ملاحظة |
لا تقم باستدعاء StopCaching من معالج الأحداث للحدث Shutdown من مستند أو ورقة العمل. حينما يُرفع الحدث Shutdown، يكون من المتأخر جدا تعديل ذاكرة تخزين البيانات المؤقتة. لمزيد من المعلومات حول الحدث Shutdown، راجع الأحداث في مشاريع Office. |
راجع أيضًا:
المهام
كيفية القيام بما يلي: تخزين البيانات مؤقتًا للاستخدام دون اتصال أو على خادم
كيفية القيام بما يلي: تخزين البيانات مؤقـتًا في مستند محمي بكلمة مرور
المبادئ
الوصول إلى البيانات في المستندات على الخادم
موارد أخرى