عنصر مضيف المصنف
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
العنصر المضيف Workbook هو نوع يوسع النوع Microsoft.Office.Interop.Excel.Workbook من تجميع التوافق الأساسي لـ EXCEL. العنصر المضيف Workbook يوفر نفس كافة خصائص وأساليب وأحداث كائن Microsoft.Office.Interop.Excel.Workbook ، كما يوفر أيضاً ميزات إضافية.
في المشاريع على مستوى المستند ، يوجد عنصر مضيف Workbook افتراضي يمثل ورقة العمل في المشروع الخاص بك. في المشاريع على مستوى التطبيق ، يمكنك إنشاء عناصر مضيف Workbook في وقت التشغيل.
فهم العنصر المضيف الخاص بورقة العمل في المشاريع على مستوى المستند
للوصول إلى ورقة العمل في المشروع الخاص بك , استخدم الفئة ThisWorkbook . تمنحك فئة ThisWorkbook حق الوصول إلى أعضاء العنصر المضيف Workbook لتنفيذ مهام أساسية في التخصيص الخاص بك مثل تشغيل التعليمات البرمجية عند فتح ورقة العمل أو إغلاقها. لمزيد من المعلومات، راجع برمجة تخصيصات علي مستوي مستند.
توفر الفئة ThisWorkbook موقعا حيث يمكنك بدء كتابة التعليمات البرمجية في المشروع الخاص بك. لأن الفئة توفر نفس الخصائص والأساليب والأحداث كلها ككائن Microsoft.Office.Interop.Excel.Workbook في تجميع التوافق الأساسي لـ Excel، يمكنك أيضاً استخدام ThisWorkbook للوصول إلى نموذج كائن Excel. لمزيد من المعلومات، راجع نظرة عامة لنموذج كائن Excel.
انقر نقراً مزدوجاً فوق عنصر المشروع ThisWorkbook في مستكشف الحلول لعرض مصمم المصنف و لعرض خصائص وأحداث المصنف في النافذة خصائص.
قيود العنصر المضيف الخاص بورقة العمل في المشاريع من مستوى المستند
يمكن أن يحتوي المشروع على مستوى المستند على عنصر مضيف Workbook واحد فقط (أي، الفئة ThisWorkbook ). لا يمكنك إضافة عناصر مضيفة Workbook جديدة إلى المشروع الخاص بك و لا يمكنك إنشاء عناصر مضيفة Workbook جديدة في وقت التشغيل للتخصيص على مستوى المستند.
إذا قمت بإنشاء ورقة عمل Excel جديدة في وقت التشغيل ، ستكون من النوع Microsoft.Office.Interop.Excel.Workbook. لأنه ليس عنصرا مضيفا، لا يمكن أن يحتوي على أية عناصر تحكم مضيفة أو عناصر تحكم Windows Forms. للحصول على مزيد من المعلومات حول إنشاء أوراق عمل في وقت التشغيل ، راجع كيفية القيام بما يلي: إنشاء مصنفات جديدة.
العنصر المضيف Workbook لا يقوم بدور حاوية عناصر تحكم المضيف. لذلك، لا يمكنك إضافة أي عناصر تحكم مرئية إلى المصنف ولكن يمكنك إضافة مكونات, مثل DataSet ، بحيث يمكن مشاركة المكونات بواسطة كافة أوراق العمل. في مشروع علي مستوي المستند ، المكونات المتوفرة للمصنف يمكن العثور عليها في التبويب مكون، و التبويب بيانات و التبويب كافة Windows Forms من مربع الأدوات.
ملاحظة
أدوات تطوير Office في Visual Studio لا تدعم المصنفات المشتركة.
فهم عناصر المضيف الخاصة بورقة العمل في المشاريع على مستوى التطبيق
في المشاريع التي على مستوى التطبيق ، يمكنك إنشاء عنصر مضيف Workbook في وقت التشغيل لأي ورقة عمل مفتوحة في Excel. لإنشاء عنصر مضيف Workbook ،استخدم الأسلوب GetVstoObject . لمزيد من المعلومات، راجع توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل.
راجع أيضًا:
المبادئ
توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل
نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف
أتمتة Excel عن طريق استخدام الكائنات الموسعة
القيود البرمجية للعناصر مضيفة وعناصر التحكم