استيراد مكتبة نوع كتجميع

وتوجد ملفات تعريف أنواع COM عادة في مكتبة نوع. وفي المقابل، إنتاج compilers متوافق مع CLS نوع بيانات التعريف في تجميع. الثاني تكون المصادر معلومات نوع مختلف تماما. يصف هذا الموضوع التقنيات لإنشاء بيانات التعريف من مكتبة نوع. التجميع الناتج يسمى تجميع التوافق، و نوع يحتوي على معلومات تمكن التطبيقات من برنامج.NET Framework باستخدام COM نوع s.

هناك طريقتان لجعل هذا نوع المعلومات المتوفرة للتطبيق الخاص بك:

  • استخدام تصميم-الوقت-تجميعات إمكانية التشغيل المتداخل فقط: يبدأ بـ .NET Framework الإصدار 4, يمكن إرشاد المحول البرمجي في تضمين معلومات نوع من تجميع التوافق في في الملف القابل للتنفيذ الخاص بك. المحول البرمجي بتضمين فقط نوع المعلومات التي يستخدمها تطبيق الخاص بك. ليس لديك إلى نشر تجميع التوافق مع تطبيق الخاص بك. هذا هو الأسلوب المستحسن.

  • نشر تجميعات إمكانية التشغيل المتداخل: يمكنك إنشاء مرجع قياسي إلى تجميع التوافق. في هذه الحالة، يجب أن يتم نشر تجميع التوافق مع تطبيق الخاص بك. إذا كنت تستخدم هذه التقنية، وعدم استخدام خاص مكون COM، دائماً مرجع تجميع التوافق الأساسية (PIA) المنشورة من قبل المؤلف مكون COM ترغب في تضمينها في تعليمات برمجية المدارة. للحصول على مزيد من المعلومات حول إنتاج و باستخدام تجميعات إمكانية التشغيل المتداخل الأساسية، راجع تجميعات توافق أساسي.

عند استخدام تجميعات إمكانية التشغيل المتداخل للتصميم وقت التشغيل فقط، يمكنك يضمّن معلومات نوع من تجميع التوافق الأساسي المنشورة من قبل مؤلف COM مكوّن. ومع ذلك، لم يكن إلى نشر تجميع إمكانية التشغيل المتداخل الأساسي مع تطبيق الخاص بك.

استخدام تجميعات إمكانية التشغيل المتداخل للتصميم وقت التشغيل فقط إلى تقليل الحجم تطبيق الخاص بك، beca استخدم لا معظم التطبيقات استخدم الجميع ميزات مكون COM. المحول البرمجي هو فعال جداً عند يضمّن معلومات النوع؛ إذا كان تطبيق الخاص بك يستخدم بعض الأساليب الموجودة تشغيل واجهة COM، المحول البرمجي عدم يضمّن الأساليب غير المستخدمة. عندما يتفاعل مع تطبيق آخر مثل تطبيق الذي قام بتضمين معلومات نوع أو يتفاعل مع أي تطبيق يستخدم تجميع التوافق أساسي، اكتب يستخدم وقت تشغيل اللغة العامة قواعد تماثل إلى تحديد ما إذا كان نوعين بنفس الاسم تمثل نفس النوع COM. ليس لديك لمعرفة هذه القواعد لاستخدام الكائنات COM. ومع ذلك، إذا كنت مهتما بالقواعد، راجع اكتب تماثل و Interop مضمنة أنواع.

إنشاء بيانات التعريف

يمكن أن تكون مكتبات نوع COM المستقلة الملفات التي لها ملحق.tlb، مثل Loanlib.tlb. بعض مكتبات نوع المضمنة في مقطع مورد من ملف.dll أو.exe. المصادر معلومات مكتبة أنواع ملفات.olb و.ocx.

بعد you بحث the نوع مكتبة that يحتوي على the implementation of your الهدف COM نوع, you have the following خيارات for generating an تجميع التوافق containing نوع بيانات التعريف:

  • Visual Studio

    ‏‫Visual Studio automatically converts COM أنواع في a نوع مكتبة إلى بيانات التعريف في an تجميع. للحصول على إرشادات، راجع كيف إلى: إضافة مراجع إلى نوع مكتبات و الإرشادات التفصيلية: تضمين معلومات النوع من التجميعات (#C و Visual Basic).

  • نوع مكتبة Importer (Tlbimp.exe)

    The نوع مكتبة Importer provides الأمر-خط خيارات إلى adjust بيانات التعريف في the resulting interop ملف, imports أنواع من an موجود نوع مكتبة, و generates an تجميع التوافق و a مساحة الاسم. للحصول على إرشادات، راجع كيف إلى: توليد Interop تجميعات من نوع مكتبات.

  • فئة System.Runtime.InteropServices.TypeLibConverter .

    This فئة provides وظائف إلى تحويل أصناف مساعدة و الواجهات في a نوع مكتبة إلى بيانات التعريف within an تجميع. It produces the same بيانات التعريف إخراج كـ Tlbimp.exe. However, unlike Tlbimp.exe, the TypeLibConverter فئة can تحويل an في-ذاكرة نوع مكتبة إلى بيانات التعريف.

  • مخصص wrappers

    When a نوع مكتبة هو غير متوفرة أو incorrect, واحد خيار هو إلى إنشاء a duplicate تعريف of the فئة أو واجهة في مدارة المصدر تعليمات برمجية. You then يحول برمجياً the المصدر تعليمات برمجية مع a compiler that targets the وقت التشغيل إلى produce بيانات التعريف في an تجميع.

    إلى define COM أنواع manually, you must have الوصول إلى the following عناصر:

    • Precise descriptions of the أصناف مساعدة و الواجهات being defined.

    • A compiler, such كـ the C# compiler, that can توليد the appropriate .NET Framework فئة ملفات تعريف.

    • Knowledge of the نوع مكتبة-إلى-تجميع تحويل rules.

    Writing a مخصص برنامج تضمين هو an متقدم technique. For إضافى معلومات حول how إلى توليد a مخصص برنامج تضمين, see Customizing قياسي Wrappers.

For المزيد معلومات حول the توافق COM استيراد عملية, see نوع مكتبة إلى تجميع تحويل خلاصة.

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة مراجع إلى مكتبات نوع

كيفية القيام بما يلي: توليد تجميعات Interop من مكتبات نوع

المرجع

Tlbimp.exe (مستورد مكتبة الأنواع)

TypeLibConverter

المبادئ

يتعرض لمكونات COM إلى.NET Framework

تخصيص Wrappers قياسي

استخدام أنواع COM في تعليمات برمجية مُدارة

ترجمة مشروع Interop

نشر تطبيق Interop

موارد أخرى

مكتبة نوع للمهمة الموجزة لتحويل المجموعة

الإرشادات التفصيلية: تضمين معلومات النوع من التجميعات (#C و Visual Basic)