‏‫نظرة عامة لنموذج كائن Excel

مقالة
11/01/2010

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

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

نوع المشروع

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

إصدار Microsoft Office

Excel 2007
Excel 2010

لتطوير حلول تستخدم Microsoft Office Excel, يمكنك التفاعل مع الكائنات المتوفرة من قبل نموذج كائن Excel. هذا الموضوع يقدم الكائنات الأكثر أهمية:

يتبع نموذج الكائن بشكل كبير واجهة المستخدم. كائن Application يمثل التطبيق بأكمله و كل كائن Workbook يحتوي على مجموعة من كائنات Worksheet. و من هنا، فإن التجريد الرئيسي التي يمثل الخلايا هو الكائن Range الذي يمكنك مع العمل مع خلايا فردية أو مجموعة من الخلايا.

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

يوفر هذا الموضوع نظرة عامة مختصرة حول نموذج كائن Excel. بالنسبة للموارد حيث يمكنك معرفة المزيد حول نموذج كائن Excel بأكمله, راجع استخدام وثائق نموذج كائن Excel.

ارتباط إلى فيديو للحصول على عرض فيديو توضيحي ذي صلة، راجع كيف يمكنني القيام بما يلي: استخدام معالجات الحدث في الوظيفة الإضافية فى Excel 2007 ؟, و كيف يمكنني القيام بما يلي: استخدام أشكال لإنشاء مخطط فقاعي في Excel ؟.

الوصول إلى كائنات في مشروع Excel

عند إنشاءك مشروع جديد علي مستوى التطبيق في Excel، يقوم Visual Studio تلقائياً بإنشاء ملف التعليمات البرمجية ThisAddIn.vb أو ThisAddIn.cs. يمكنك الوصول إلى كائن التطبيق باستخدام Me.Application أو this.Application.

عند إنشاءك مشروع جديد علي مستوى المستند لـ Excel لديك خيار إنشاء مصنف Excel جديد أو مشروع قالب Excel جديد. تلقائياً يقوم Visual Studio بإنشاء الملفات التعليمات البرمجية التالية في مشروع Excel الجديد الخاص بك لكلٍ من المصنف وقالب المشاريع .

Visual Basic	C#‎
ThisWorkbook.vb	ThisWorkbook.cs
Sheet1.vb	Sheet1.cs
Sheet2.vb	Sheet2.cs
Sheet3.vb	Sheet3.cs

يمكنك استخدام فئة Globals في المشروع للوصول إلى ThisWorkbook ، أو Sheet1 ، Sheet2, أو Sheet3 من خارج class. المعنية لمزيد من المعلومات، راجع الوصول العمومي إلى الكائنات في مشاريع Office. يستدعي المثال التالي الأسلوب PrintPreview الخاص بـ Sheet1 بغض النظر عن ما إذا كانت التعليمات البرمجية موضوعة في واحد من الفئات Sheet n أو الفئة ThisWorkbook .

Globals.Sheet1.PrintPreview()

Globals.Sheet1.PrintPreview(missing);

لأن البيانات في مستند Excel قوية البنية, نموذج الكائن هرمي ومباشر. يوفر Excel مئات الكائنات التي قد تحتاجها للتعامل معها، ولكن يمكنك الحصول على بداية جيدة على نموذج الكائن بالتركيز على مجموعة فرعية صغيرة من الكائنات المتوفرة. هذه الكائنات تتضمن الأربع الكائنات التالية:

التطبيق
مصنف
Worksheet
النطاق

أكبر كمية من العمل المنجز فى Excel تدور حول هذه الكائنات الأربعة وأعضائهم.

كائن التطبيق

كائن Excel Application ، يمثل تطبيق Excel نفسه. الكائن Application يعرض قدرا كبيرا من المعلومات حول التطبيق قيد التشغيل, و الخيارات التي تطبق لذلك المثيل و كائنات المستخدم المفتوحة حالياً داخل المثيل.

ملاحظة

لا يجب عليك تعيين خاصية EnableEvents بكائن Application في Excel إلى false. إعداد هذه الخاصية إلى false يمنع Excel من رفع أية أحداث بما في ذلك أحداث عناصر تحكم المضيف.

كائن المصنف

كائن Microsoft.Office.Interop.Excel.Workbook يمثل مصنف واحد داخل التطبيق Excel.

أدوات تطوير Office في Visual Studio توسع الكائن Microsoft.Office.Interop.Excel.Workbook بواسطة توفير النوعMicrosoft.Office.Tools.Excel.Workbook. هذا النوع يمنحك حق الوصول إلى كافة مميزات الكائن Microsoft.Office.Interop.Excel.Workbook بالإضافة إلى المميزات الجديدة مثل القدرة على إضافة العلامات الذكية إلى المصنف. لمزيد من المعلومات، راجع عنصر مضيف المصنف.

كائن ورقة العمل

كائن Microsoft.Office.Interop.Excel.Worksheet من أعضاء مجموعة Worksheets. كثير من خصائص وأساليب وأحداث Microsoft.Office.Interop.Excel.Worksheet تطابق أو تشابه الأعضاء التى توفرها كائنات Application أو Microsoft.Office.Interop.Excel.Workbook.

يوفر Excel مجموعة Sheets كخاصية لكائن Microsoft.Office.Interop.Excel.Workbook. كل عضو من مجموعة Sheets هو إما كائن Microsoft.Office.Interop.Excel.Worksheet أو Microsoft.Office.Interop.Excel.Chart.

أدوات تطوير Office في Visual Studio توسع الكائن Microsoft.Office.Interop.Excel.Worksheet بواسطة توفير النوعMicrosoft.Office.Tools.Excel.Worksheet. هذا النوع يعطيك إمكانية الوصول لكافة المميزات للكائن Microsoft.Office.Interop.Excel.Worksheet بالإضافة إلى المميزات الجديدة مثل القدرة على استضافة عناصر التحكم المدارة ومعالجة أحداث جديدة. لمزيد من المعلومات، راجع عنصر مضيف خاص بورقة عمل.

كائن النطاق

كائن Microsoft.Office.Interop.Excel.Range هو الكائن الذي ستقوم باستخدامه اكثر داخل تطبيقات Excel الخاص بك. قبل أن تقوم بمعالجة أية منطقة داخل Excel يجب أن تعبر عنها ككائن Range و أن تعمل مع أساليب و خصائص هذا النطاق. كائن Range يمثل خلية أو صف أو عمود أو مجموعة محددة من الخلايا التي تحتوي على كتلة واحد أو أكثر من الخلايا (التي قد أو قد لا تكون متجاورة) أو حتى مجموعة من الخلايا على عدة أوراق.

يقوم Visual Studio بتوسيع كائن Microsoft.Office.Interop.Excel.Range بواسطة توفير الأنواع Microsoft.Office.Tools.Excel.NamedRange و Microsoft.Office.Tools.Excel.XmlMappedRange. هذه الأنواع لها معظم المميزات ككائن Microsoft.Office.Interop.Excel.Range بالإضافة إلى المميزات الجديدة مثل قدرة ربط البيانات و أحداث جديدة. للمزيد من المعلومات، راجع عنصر تحكم NamedRange وعنصر تحكم XmlMappedRange.

استخدام وثائق نموذج الكائن الخاصة بـ Excel

للحصول على معلومات حول الفئات التي يمكنك استخدامها في نموذج كائن Excel، راجع مجموعات الوثائق فيما يلي:

الرابط الأول يوفر معلومات حول الفئات و الواجهات في ‏‫تجميع التوافق الأساسي‬ لـ Excel. الرابط الثاني يوفر معلومات حول نموذج كائن Excel كما يتم عرضها إلى تعليمة "Visual Basic للتطبيقات (VBA)" البرمجية تحتوي كل مجموعة من الوثائق علي مزايا وعيوب للمطورين الذين يستخدمون أدوات تطوير Office في Visual Studio.

مرجع تجميع التوافق الأساسي

توضح هذه الوثائق كل أنواع تجميع التوافق الأساسي في Excel التي يمكنك استخدامها في مشاريع Office. ومع ذلك، تحتوي هذه الوثائق علي العيوب التالية:

لا يمكن تمت الإضافة عناصر تحكم مضيف برمجياً. تعيين وقت التشغيل يتم إرجاع كائن إلى خاصية كائن الذي يمثل إضافة-بوصة
لا توفر أي أمثلة للتعليمات البرمجية حتى ذلك الوقت.

مرجع VBA:

كافة الكائنات و الأعضاء في مرجع VBA تطابق الفئات و الأعضاء في تجميع التوافق الأساسي التي تستخدمها في مشاريع Office. على سبيل المثال، كائن ورقة العمل في وثائق Excel VBA يناظر الفئة Microsoft.Office.Interop.Excel.Worksheet في تجميع التوافق الأساسي .

مرجع VBA فيه المميزات التالية:

يوفر أمثلة تعليمات برمجية لمعظم الأعضاء .

مرجع VBA فيه العيوب التالية:

يوفر أمثلة بناء الجملة و التعليمة البرمجية لـ VBA فقط. لاستخدم أمثلة التعليمة البرمجية في مشروع Office، يجب أن تقوم بترجمة تعليمة VBA البرمجية إلى Visual Basic أو Visual C#‎.

أنواع إضافية في تجميع التوافق الأساسي

تجميع التوافق الأساسي يحتوي على العديد من الأنواع غير المتوفرة لـ VBA. هذه الأنواع الإضافية التى تساعد على ترجمة الكائنات في نموذج الكائن المستند إلى COM الخاص بـ Excel إلى تعليمة برمجية مدارة ، غير معدة للاستخدام بشكل مباشر في التعليمة البرمجية الخاصة بك.

لمزيد من المعلومات، راجع Overview of Classes and Interfaces in the Office Primary Interop Assemblies.