مشاركة عبر

الإرشادات التفصيلية: إنشاء كائنات COM مع Visual Basic

  • مقالة

عند إنشاء تطبيقات أو مكونات جديدة فإنه من الأفضل إنشاء تجميعات .NET Framework. ومع ذلك، Visual Basic يسهل أيضا كشف مكوّن .NET Framework ل COM. وهذا يمكنك من توفير مكونات جديدة لمجموعات التطبيق السابق التي تتطلب مكونات COM. توضح هذه المعاينة كيفية استخدام Visual Basic لعرض كائنات الـ.NET Framework كـكائنات الـ COM ، مع وبدون قالب فئة ال COM.

إن أسهل طريقة لعرض كائنات ال COM استخدام قالب فئة ال COM. قالب فئة COM يقوم بإنشاء فئة جديدة ثم يقوم بتكوين المشروع لإنشاء الفئة و طبقة التشغيل التفاعلي ككائن COM و تسجيلها مع نظام تشغيل.

ملاحظة

على الرغم من أنه يمكن أيضاً عرض فئة منشأة في Visual Basic ككائن COM لـتعليمات برمجية غير مُدارة لاستخدامها، إنه ليس كائن COM صحيحاً ولا يمكن استخدامه بواسطة Visual Basic. لمزيد من المعلومات، راجع إمكانية التشغيل التفاعلي COM في تطبيقات NET Framework..

ملاحظة

قد تختلف مربعات الحوار وأوامر القائمة التى تشاهدها الان عن تلك الموصوفة في التعليمات اعتماداً على الإعدادات النشطة أو الإصدار الخاص بك. لتغيير الإعدادات اضغط Import and Export إعدادات ضمن أدواتالقائمة. لمزيد من المعلومات، راجع العمل مع إعدادات.

لإنشاء كائن COM باستخدام قالب فئة COM

  1. افتح نافذة مشروع تطبيقات جديدة من ملف القائمة بالنقر فوق مشروع جديد.

  2. في مشروع جديد مربع الحوار ضمنأنواع المشروع حقل ، تاكد أن النافذة محدده. تحديدمكتبة الفئة من the قوالب قائمة، ثم انقر فوق ‏‏موافق. الـمشروع الجديد. معروض

  3. تحديدإضافة عنصر جديد من مشروع قائمة. مربع الحوار "إضافة عنصر جديد" يتم عرضه.

  4. تحديدفئة COM من قوالب سرد له ثم انقر فوق إضافة. Visual Basic إضافة فئة جديدة وتكوين مشروع جديد لـتوافق COM.

  5. قم بإضافة التعليمات البرمجية مثل الخصائص والأساليب والأحداث إلى فئة COM.

  6. تحديدقم ببنية ClassLibrary1 منبنية قائمة. Visual Basic يبني التجميع و يسجيل كائن COM مع نظام التشغيل.

إنشاء كائنات COM بدون قالب فئة COM

يمكنك أيضاً إنشاء فئة COM يدوياً بدلاً من استخدام قالب فئة COM. هذا إجراء مفيد عند العمل من خط الأوامر أو عندما تريد مزيد من التحكم في كيفية كائنات COM معرّفة.

لتعيين مشروعك لإنشاء كائن COM

  1. افتح نافذة مشروع تطبيقات جديدة من ملف القائمة بالنقر فوق جديد مشروع .

  2. في مشروع جديد مربع الحوار ضمنأنواع المشروع حقل ، تاكد أن النافذة محدده. تحديدمكتبة الفئة من the قوالب قائمة، ثم انقر فوق ‏‏موافق. الـمشروع الجديد. معروض

  3. في مستكشف الحلول انقر بالزر الأيمن فوق مشروعك، ثم انقر فوق خصائص. مصمم مشروع معروض.

  4. انقر فوقالمحول البرمجياً علامة تبويب.

  5. تحديدتسجيل لـ توافق COM خانة اختيار.

لإعداد تعليمات برمجية الموجودة في فئتك لإنشاء كائن COM

  1. في مستكشف الحل انقر مزودجاClass1.vb لعرض تعليمات برمجية الخاصة به.

  2. إعادة تسمية الفئة إلى ComClass1.

  3. إضافة الثوابت التالية إلى ComClass1. سوف يتم تخزين ثوابت المعرّف الفريد العام (معرّف فريد عالمي) الذي كائنات COM تحتاجة.

    Public Const ClassId As String = ""
Public Const InterfaceId As String = ""
Public Const EventsId As String = ""

  4. من القائمة أدوات، انقر فوق إنشاء كتالوج. في الحوارإنشاء معرّف فريد عالمي (معرّف فريد عالمي) ، انقر فوق تنسيق السجل ثم انقر فوقنسخ. انقر فوق إنهاء.

  5. استبدال السلسلة الفارغه ClassId مع معرّف فريد عالمي (معرّف فريد عالمي) ، و إزالة أقواس البادئة و زائدة. على سبيل المثال، إذا GUID المزوّدَ مِن قِبل Guidgen "{2C8B0AEE-02C9-486e-B809-C780A11530FE}" يجب أن تظهر التعليمات البرمجية الخاصة بك كما يلي.

    Public Const ClassId As String = "2C8B0AEE-02C9-486e-B809-C780A11530FE"

  6. كرر الخطوات السابقة InterfaceId و EventsId ثوابت، كما في المثال التالي.

    Public Const InterfaceId As String = "3D8B5BA4-FB8C-5ff8-8468-11BF6BD5CF91"
Public Const EventsId As String = "2B691787-6ED7-401e-90A4-B3B9C0360E31"

    ملاحظة

    تأكّدْ بأنّ GUIDs جديد وفريد; أخرى الحكيم، عدا ذلك، مكوّن COM يُمْكِنُ أَنْ يتضارب بمكوّناتِ COM أخرى.

  7. إضافةComClass سمة إلى ComClass1، يحدد GUIDs لمعرف الفئة معرّف الواجهة ومعرّف الأحداث كما هو موضح في المثال التالي:

    <ComClass(ComClass1.ClassId, ComClass1.InterfaceId, ComClass1.EventsId)>
Public Class ComClass1

  8. يَجِبُ أَنْ يكونَ عِنْدَ فئات COM معلمات لا يستند إليها Public Sub New() مُنشئ، أو الفئة لن تسجل بشكل صحيح. إضافة الدالة الإنشائية بدون معلمات للفئة:

    Public Sub New()
    MyBase.New()
End Sub

  9. إضافة خصائص وأساليب وأحداث إلى فئة إنهائها بEnd Class العبارة. اختارحل بنية، من بنية قائمة. Visual Basic يبني التجميع و يسجيل كائن COM مع نظام التشغيل.

    ملاحظة

    كائنات COM التي تنشؤها Visual Basic لا يُمكنُ أَنْ يَكُونَ مستعمل من قبل الآخر Visual Basic تطبيقات لأنها كائنات COM غير صحيحة. المحاولات لإضافة الإشاراتِ إلى مثل هذه كائنات COM سوف يرفع خطأ. للمزيد من التفاصيل ، راجع إمكانية التشغيل التفاعلي COM في تطبيقات NET Framework..

راجع أيضًا:

المهام

الإرشادات التفصيلية: تطبيق توريث مع كائنات COM

استكشاف أخطاء التشغيل المتداخل

المرجع

ComClassAttribute

# توجيه منطقة

موارد أخرى

توافق COM

إمكانية التشغيل التفاعلي COM في تطبيقات NET Framework.