Regasm.exe (أداة تسجيل التجميع)

تقوم أداة تسجيل التجميع بقراءة بيانات التعريف داخل تجميع و إضافة الإدخالات الضرورية على السجل الذي يسمح لعملاء COM بإنشاء فئات .NET Framework بشفافية, و بمجرد تسجيل فئة ما, فإن أي عميل لـ COM يمكنه استخدامه كما لو أن الفئة فئة لـ COM, و لكن عند تثبيت التجميع يتم تسجيل الفئة مرة واحدة فقط, و مثيلات الفئات داخل التجميع لا يمكن إنشاؤها من COM إلى أن يتم تسجيلها فعلياً.

يتم تلقائياً تثبيت أداة تسجيل التجميع مع ‏‫Visual Studio, و لتشغيل الأداة استخدم موجه أوامر Visual Studio.. في موجه الأوامر، اكتب ما يلي:

regasm assemblyFile [options]

المعلمات

المعلمة

الوصف

ملف التجميع

يقوم بتسجيل التجميع مع COM.

الخيار

الوصف

/codebase

يقوم بإنشاء إدخال للتعليمات البرمجة الأساسية في السجل حيث يقوم إدخال التعليمات البرمجة الأساسية بتحديد مسار الملف لتجميع غير مثبت في مخزن التجميع العمومي المؤقت, و لكن لا يجب عليك تحديد هذا الخيار إذا كنت ستقوم فيما بعد بتثبيت التجميع الذي تقوم بتسجيله إلى مخزن التجميع العمومي المؤقت, و الوسيطة assemblyFile التي تحددها مع الخيار /codebase يجب أن تكون تجميع باسم واضح.

/registered

يحدد أن هذه الأداة سوف تشير فقط إلى نوع المكتبات التي تم تسجيلها بالفعل.

/asmpath:directory

تعيّن دليل يحتوي على مراجع التجميع حيث يجب أن يستخدم مع الخيار /regfile.

/nologo

يقوم بمنع عرض شعار بدء التشغيل للـ Microsoft.

/regfile [:regFile]

ينشئ ملف .reg المحدد للتجميع و الذي يحتوي على إدخالات السجل المطلوبة, و لكن تحديد هذا الخيار لا يؤدي إلى تغيير السجل, و لا يمكنك استخدام هذا الخيار مع الخيارات /u أو /tlb.

/silent أو /s

يقوم بمنع عرض رسائل النجاح.

/tlb [:typeLibFile]

ينشئ مكتبة أنواع من التجميع المحدد تتضمن ملفات تعريف للأنواع التي يمكن الوصول إليها و المعرفة داخل التجميع.

/ إلغاء تسجيل أو /u

لا يسجل الفئات القابلة للإنشاء و التي تم العثور عليها في assemblyFile, فحذف هذا الخيار يؤدي إلى قيام Regasm.exe بتسجيل الفئات القابلة للإنشاء في التجميع.

/verbose

تحديد وضع verbose; يقوم بعرض قائمة للتجميعات المشار إليه و التي تحتاجها مكتبة الأنواع حتى يتم إنشاؤها عند تحديدها مع الخيار /tlb.

/? أو /help

يقوم بعرض بناء جملة الأمر والخيارات للأداة.

ملاحظةملاحظة

خيارات سطر الأوامر لـ Regasm.exe حساسة لحالة الأحرف,وهكذا أنت بحاجة فقط لتقديم ما يكفي من الخيار لتعريفه بشكل فريد,فعلى سبيل المثال, إن /n is equivalent to /nologo and /t:outfile.tlb is equivalent to /tlb:outfile.tlb.

ملاحظات

يمكنك استخدام الخيار /regfile لإنشاء ملف .reg الذي يحتوي على إدخالات السجل بدلاً من إجراء التغييرات مباشرة إلى السجل, و يمكنك تحديث السجل على جهاز كمبيوتر عن طريق استيراد الملف .reg مع أداة محرر السجل (Regedit.exe), و لاحظ أن ملف .reg لا يحتوي على أية تحديثات للسجل التي يمكن إجراؤها بواسطة وظائف السجل المعرفة من قبل المستخدم, علماً بإن الخيار /regfile فقط يبعث إدخالات السجل للفئات المدارة, لكنه لا يقوم بإرسال إدخالات لـ TypeLibIDs أو InterfaceIDs.

عندما تحدد الخيار /tlb, فإن Regasm.exe ينشئ و يسجل مكتبة أنواع تصف الأنواع الموجودة في التجميع حيث يقوم Regasm بوضع مكتبات الأنواع المنشأة في الدليل المشغَّل الحالي أو في الدليل المحدد لملف الإخراج, فإنشاء مكتبة أنواع للتجميع تشير إلى تجميعات أخرى قد يؤدي إلى إنشاء العديد من مكتبات الأنواع في وقت واحد, و يمكنك استخدام مكتبة الأنواع لتوفير معلومات النوع إلى أدوات التطوير مثل Visual Studio 2005, و لكنه يجب عدم استخدام الخيار /tlb في حالة كان التجميع الذي تقوم بتسجيله قد تم إنتاجه بواسطة مكتبة الأنواع للمستورد (Tlbimp.exe) حيث لا يمكنك إصدار مكتبة أنواع من تجميع تم استيراده من مكتبة أنواع, فاستخدام الخيار /tlb له نفس تأثير استخدام مُصدّر مكتبة الأنواع و Regasm.exe (Tlbexp.exe) مع الاستثناء حيث Tlbexp.exe لا يقوم بتسجيل مكتبة الأنواع التي ينتجها, أما إذا كنت تستخدم الخيار /tlb لتسجيل مكتبة أنواع فإنه يمكنك استخدام الخيار /tlb مع الخيار /unregister لعدم تسجيلها, فاستخدام الخيارين التاليين معاً سوف يلغي تسجيل مكتبة الأنواع و واجهة الإدخالات التي يمكنها مسح السجل بشكل كبير.

عند تسجيل تجميع حتى يتم استخدامه من قبل COM فإن Regasm.exe يقوم بإضافة إدخالات إلى السجل على الكمبيوتر المحلي, وعلى وجه التحديد، فإنه ينشئ مفاتيح التسجيل المعتمدة على النسخة التي تسمح للإصدارات المتعددة للتجميع نفسه لتعمل جنباً إلى جنب على جهاز كمبيوتر, ففي المرة الأولى التي يتم فيها تسجيل تجميع يتم إنشاء مفتاح واحد في المستوى الأعلى للتجميع و يتم إنشاء مفتاح فرعي فريد من نوعه للإصدار المحدد, و يقوم Regasm.exe بإنشاء مفتاح فرعي للإصدار الجديد في كل مرة تقوم بتسجيل إصدار جديد للتجميع.

على سبيل المثال، النظر في سيناريو حيث قمت بتسجيل المكون المدار و myComp.dll و الإصدار 1.0.0.0 للاستخدام من قبل COM, ففي وقت لاحق تقوم بتسجيل myComp.dll للإصدار 2.0.0.0, حيث إنك قمت بتحديد قيام كافة تطبيقات العميل COM على الكمبيوتر باستخدام myComp.dll لإصدار 2.0.0.0 و قررت إلغاء تسجيل myComponent.dll لإصدار 1.0.0.0, و يسمح لك نظام السجل بإلغاء تسجيل myComp.dll لإصدار 1.0.0.0 بسبب إزالة مفتاح فرعي لإصدار 1.0.0.0 فقط.

بعد تسجيل تجميع باستخدام Regasm.exe يمكنك تثبيته في مخزن التجميع العمومي المؤقت بحيث يمكن تنشيطه من أي عميل COM, ففي حالة تنشيط التجميع بواسطة تطبيق واحد فقط يمكنك وضعه في دليل التطبيق.

أمثلة

يقوم الأمر التالي بتسجيل كافة الفئات العامة المضمنة في myTest.dll.

regasm myTest.dll

يقوم الأمر التالي بإنشاء الملف myTest.reg الذي يحتوي على كافة إدخالات السجل الضرورية, و لكنه لا يقوم بتحديث السجل.

regasm myTest.dll /regfile:myTest.reg

يقوم الأمر التالي بتسجيل كافة الفئات العامة الموجودة في myTest.dll ثم يقوم بإنشاء و تسجيل مكتبة الأنواع myTest.tlb التي تحتوي على ملفات تعريف لكافة الأنواع العامة المعرفة في myTest.dll.

regasm myTest.dll /tlb:myTest.tlb

راجع أيضًا:

المرجع

Tlbexp.exe (مُصدّر مكتبة الأنواع)

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

موجه أوامر Visual Studio.

المبادئ

تسجيل التجميعات مع COM

موارد أخرى

أدوات .NET Framework