مشاركة عبر


عنصر مضيف خاص بورقة عمل

ينطبق على

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

نوع المشروع

  • مشروعات على مستوى المستند

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • Excel 2007

  • Excel 2010

العنصر المضيف Worksheet هو نوع يوسع النوع Microsoft.Office.Interop.Excel.Worksheet من تجميع التوافق الأساسي لـ EXCEL. يوفر العنصر المضيف Worksheet كافة الخصائص و الأساليب و الأحداث كـكائن Microsoft.Office.Interop.Excel.Worksheet ولكنه أيضًا يقوم بالكشف عن أحداث إضافية ويعمل كحاوية لعناصر تحكم المضيف وعناصر تحكم Windows Forms.

في المشاريع التي علي مستوي المستند ، يمكنك إضافة العناصر المضيفة Worksheet إلى المشروع في وقت التصميم. في المشاريع على مستوى التطبيق ، يمكنك إنشاء عناصر مضيف Worksheet في وقت التشغيل.

فهم العناصر المضيفة في ورقة العمل في المشاريع على مستوى المستند

عند إنشاء مشروع علي مستوى المستند لـ Excel يقوم Visual Studio تلقائياً بإنشاء ثلاثة عناصر مضيفة Worksheet في المشروع. الأسماء الافتراضية لأوراق العمل هي Sheet1 و Sheet2 ، و Sheet3. إذا قمت بإنشاء مشروع يستند علي مصنف موجود، يعتمد عدد عناصر المضيف على عدد أوراق العمل في المصنف.

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

توفر فئات ورقة العمل موقعا حيث يمكنك بدء كتابة التعليمات البرمجية في المشروع الخاص بك. لأن الفئة توفر نفس الخصائص والأساليب والأحداث كلها كـكائن Microsoft.Office.Interop.Excel.Worksheet في تجميع التوافق الأساسي لـ EXCEL، يمكنك أيضاً استخدام هذه الفئات للوصول إلى نموذج كائن EXCEL. لمزيد من المعلومات، راجع ‏‫نظرة عامة لنموذج كائن Excel.

في المشاريع التي علي مستوى المستند ، يمكنك إضافة عناصر مضيفة Worksheet إضافية إلى المشروع في وقت التصميم عن طريق إضافة ورقة عمل جديدة إلى المصنف في المصمم.

إعادة تسمية أوراق العمل

في المشروع علي مستوي المستند، يمكنك إعادة تسمية أوراق العمل في مصمم Visual Studio ولكن هذا يغير اسم ورقة العمل المعروض فقط. الاسم البرمجي مازال هو الاسم الافتراضي لورقة العمل. إذا قمت بإعادة تسمية ورقة العمل في النافذة‏‎ خصائص يتم تغيير الاسم البرمجي فقط.

قيود العنصر المضيف الخاص بورقة العمل في المشاريع علي مستوى المستند

لا يمكنك إنشاء عنصر مضيف Worksheet جديد في وقت التشغيل في المشاريع علي مستوى المستند. إذا قمت بإنشاء ورقة عمل EXCEL جديدة في وقت التشغيل، ستكون من النوع Microsoft.Office.Interop.Excel.Worksheet. لأنه ليس عنصرا مضيفا، لا يمكن أن يحتوي على أية عناصر تحكم مضيفة أو عناصر تحكم Windows Forms. للحصول على مزيد من المعلومات حول إنشاء مستندات في وقت التشغيل ، راجع كيفية القيام بما يلي: إضافة ورق عمل جديد إلى المصنفات.

فهم العناصر المضيفة الخاصة بورقة العمل في المشاريع على مستوى التطبيق

في المشاريع على مستوى التطبيق ، يمكنك إنشاء عنصر مضيف Worksheet في وقت التشغيل لأي ورقة عمل مفتوحة في EXCEL. يمكنك استخدام العنصر المضيف Worksheet لإضافة عناصر التحكم و العلامات الذكية إلى المستند المقترن أو لمعالجة الأحداث الغير المتوفرة على كائنات Microsoft.Office.Interop.Excel.Worksheet .

لإنشاء عنصر مضيف Worksheet ،استخدم الأسلوب GetVstoObject . لمزيد من المعلومات، راجع توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل.

راجع أيضًا:

المبادئ

توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل

إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل

نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف

عنصر مضيف المصنف

أتمتة Excel عن طريق استخدام الكائنات الموسعة

القيود البرمجية للعناصر مضيفة وعناصر التحكم

موارد أخرى

نماذج تطوير Office وإرشادات تفصيلية

عناصر التحكم في مستندات Office