التخزين المؤقت للبيانات
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
يمكنك تخزين كائنات بيانات مؤقتًا في تخصيص على مستوى المستند بحيث يمكن الوصول إلى البيانات دون اتصال، أو دون فتح Microsoft Office Word أو Microsoft Office Excel. لتخزين كائن ما مؤقتا، يجب أن يكون لدى الكائن نوع بيانات يلبي متطلبات معينة. العديد من أنواع البيانات الشائعة في .NET Framework تحقق هذه المتطلبات، بما في ذلك String، وDataSet، وDataTable.
هناك طريقتان لإضافة كائن إلى ذاكرة تخزين البيانات المؤقت:
لإضافة كائن إلى ذاكرة تخزين البيانات المؤقت عند إنشاء الحل، قم بتطبيق السمة CachedAttribute إلى التصريح بالكائن. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تخزين البيانات مؤقتًا للاستخدام دون اتصال أو على خادم.
لإضافة كائن إلى ذاكرة تخزين البيانات المؤقت برمجيًا في وقت التشغيل، استخدم الأسلوب StartCaching لعنصر مضيف، مثل الفئتين ThisDocument أو ThisWorkbook. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تخزين مصدر بيانات مؤقـتًا بطريقة برمجية في مستند Office.
بعد أن تقوم بإضافة كائن إلى ذاكرة تخزين البيانات المؤقت، يمكنك الوصول إلى البيانات المخزنة مؤقتًا وتعديلها بدون بدء تشغيل Word أو Excel. لمزيد من المعلومات، راجع الوصول إلى البيانات في المستندات على الخادم.
متطلبات كائنات البيانات للتخزين المؤقت
لتخزين كائن بيانات مؤقتًا في الحل الخاص بك، يجب أن يلبي الكائن هذه المتطلبات:
أن يكون حقل عام أو خاصية عامة للقراءة والكتابة خاصين بعنصر مضيف، مثل الفئتين ThisDocument أو ThisWorkbook.
ألا يكون مفهرسًا أو أية خاصية أخرى ذات معلمات.
بالإضافة إلى ذلك، يجب أن يكون كائن البيانات قابل للتسلسل بواسطة الفئة XmlSerializer، مما يعني أنه يجب أن يكون نوع الكائن لديه هذه الصفات:
أن يكون نوعًا عامًا.
أن يحتوي على منشئ عام بدون أية معلمات.
ألا يتم تنفيذ التعليمات البرمجية التي تتطلب امتيازات أمان إضافية.
أن يعرض فقط الخواص العامة التي هي للقراءة والكتابة (الخواص الأخرى سيتم تجاهلها).
ألا يعرض الصفائف متعددة الأبعاد (الصفائف المتداخلة مقبولة).
ألا يقوم بإرجاع واجهات من الخصائص والحقول.
ألا يقوم بتنفيذ IDictionary إذا كان مجموعة.
عند تخزين كائن بيانات مؤقتًا، Visual Studio Tools لوقت تشغيل Office يسلسل الكائن في XML string يتم تخزينها في جزء XML مخصص في المستند. لمزيد من المعلومات، راجع نظرة عامة على أجزاء XML.
حدود حجم البيانات المخزنة مؤقتاً
هناك بعض حدود لإجمالي مقدار البيانات التي يمكنك إضافتها إلى ذاكرة تخزين البيانات المؤقت في مستند ما، ولحجم أي كائن فردي في ذاكرة تخزين البيانات المؤقت. إذا قمت بتخطي هذه الحدود، قد يتم إغلاق التطبيق بشكل غير متوقع عندما يتم حفظ البيانات إلى ذاكرة تخزين البيانات المؤقت.
لتجنب هذه الحدود، اتبع هذه الإرشادات:
لا تقم بإضافة أي كائن أكبر من 10 MB إلى ذاكرة تخزين البيانات المؤقت.
لا تقم بإضافة أكثر من 100 MB من إجمالي البيانات إلى ذاكرة تخزين البيانات المؤقت في مستند واحد.
هذه قيم تقريبية. تعتمد الحدود بالضبط على عدة عوامل، منها ذاكرة الوصول العشوائي (RAM) وعدد العمليات قيد التشغيل.
التحكم في سلوك الكائنات المخزنة مؤقتًا
للحصول على المزيد من التحكم في سلوك كائن مخزن مؤقتًا، يمكنك تطبيق الواجهة ICachedType على نوع الكائن المخزن مؤقتًا. على سبيل المثال، يمكنك تنفيذ هذه الواجهة إذا كنت تريد التحكم في كيفية إعلام المستخدم عند تغيير الكائن. للحصول على أمثلة التعليمات البرمجية التي توضح كيفية تنفيذ ICachedType، راجع الفئة ControlCollection في نموذج عناصر التحكم الديناميكي في Excel ونموذج عناصر التحكم الديناميكي في Word في نماذج تطوير Office وإرشادات تفصيلية.
استمرار التغييرات في البيانات المخزنة مؤقتًا في المستندات المحمية بكلمات مرور
إذا قمت بتخزين كائنات بيانات مؤقتًا في مستند محمي بكلمة مرور، لا يتم حفظ التغييرات في البيانات المخزنة مؤقتاً. يمكنك حفظ التغييرات في البيانات المخزنة مؤقتًا بواسطة تجاوز أسلوبين. قم بتجاوز هذه الأساليب لإزالة الحماية مؤقتًا عند حفظ المستند، ثم قم بإعادة تطبيق الحماية بعد اكتمال عملية الحفظ.
لمزيد من المعلومات، راجع كيفية القيام بما يلي: تخزين البيانات مؤقـتًا في مستند محمي بكلمة مرور.
منع فقدان البيانات عند إضافة القيم Null إلى ذاكرة تخزين البيانات المؤقت
عند إضافة كائنات إلى ذاكرة تخزين البيانات المؤقت، يجب تهيئة كافة الكائنات المخزنة مؤقتًا إلى قيمة غير null قبل حفظ وإغلاق المستند. إذا احتوى أي كائن مخزن مؤقتًا على قيمة null عند حفظ وإغلاق المستند، فستقوم Visual Studio Tools لوقت تشغيل Office تلقائياً بإزالة كافة الكائنات المخزنة مؤقتًا من ذاكرة تخزين البيانات المؤقت.
إذا قمت بإضافة كائن بقيمة null إلى ذاكرة تخزين البيانات المؤقت باستخدام السمة CachedAttribute وقت التصميم، فيمكنك استخدام الفئة ServerDocument لتهيئة كائنات البيانات المخزنة مؤقتاً قبل فتح المستند. هذا مفيد إذا كنت تريد تهيئة البيانات المخزنة مؤقتًا على خادم دون تثبيت Word أو Excel، قبل فتح المستند بواسطة مستخدم ما. لمزيد من المعلومات، راجع الوصول إلى البيانات في المستندات على الخادم.
راجع أيضًا:
المهام
كيفية القيام بما يلي: تخزين البيانات مؤقتًا للاستخدام دون اتصال أو على خادم
كيفية القيام بما يلي: تخزين مصدر بيانات مؤقـتًا بطريقة برمجية في مستند Office
كيفية القيام بما يلي: تخزين البيانات مؤقـتًا في مستند محمي بكلمة مرور
الإرشادات التفصيلية: إنشاء علاقة رئيسي/تفصيلي باستخدام مجموعة بيانات مخزنة مؤقتاً