تحويل تجميع الذي تم تصديره

أي أداة أو API that exports an تجميع إلى a نوع مكتبة must تحويل the outermost المستوى of a مدارة تجميع أول. The عملية converts each individual تجميع في a مفرد نوع مكتبة, imposing واحد-إلى-واحد mapping between تجميع و نوع مكتبة. You cannot فصل an تجميع في multiple نوع مكتبات. An تجميع consistently produces the same نوع مكتبة, regardless of the تفاصيل أو manner of its تحويل.

تجميع و نوع مكتبة Identities

An تجميع الهوية consists of the الرابع عناصر listed في the following جدول.

العنصر	الوصف
الاسم	سلسلة used إلى identify the تجميع. Typically, this سلسلة هو the same كـ the تجميع اسم الملف without the ملحق.
مفتاح عمومي	Public part of a public/private cryptographic المفتاح ينشئ ازدواجًا.
Version	الرابع-part numeric سلسلة consisting of the رئيسي, ثانوي, بنية, و المراجعة أرقام.
الثقافة سلسلة	إعدادات محلية that the تجميع supports.

في combination, these حقول produce a اسم قوي إلى identify an تجميع.

جزئي بيان تجميع

.assembly Sample as "Sample"
{
    publickey = (00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00   
                 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00   
                 B7 3C 60 FD 2D 6B E4 14 4E BD D1 B6 1A 09 FB F1   
                 23 FF A8 62 59 B3 86 0B 0A 73 10 98 51 E5 0E D6   
                 7E 10 2F A7 6E AF 1B E5 E8 F1 2E E6 9C F7 74 9A   
                 1A 9A 83 88 2C 70 C9 8B 52 AD 97 5C 23 52 D2 42   
                 D2 6C 64 14 E7 1D 1D 55 B4 F4 9C BB 86 7B 07 99   
                 E3 19 E8 E1 4A BC 7A 40 A6 A2 9D AD 96 9B E5 CA   
                 7C 10 5B 79 16 80 29 50 CD C3 63 D0 12 81 D0 18   
                 B4 AE DA EC CC ED 8E AF A4 08 14 05 C6 9C 7B C5)
  .ver 1:0:295:37445
  .locale = (65 00 6E 00 2D 00 55 00 53 00 00 00 )   // en-US
}

في تباين, a نوع مكتبة الهوية consists of three عناصر: a مكتبة معرّف (LIBID), the الإصدار, و a محلي Identification (LCID). لا هذا ولا ذاك the اسم of the ملف containing the نوع معلومات, nor the friendly اسم defined within the مكتبة, هو part of the مكتبة's الهوية. You can بحث a نوع مكتبة through the السجل بواسطة using its LIBID, الإصدار, و LCID.

تمثيل مكتبة نوع

[ uuid(0D26FC72-7EB1-4565-AA75-DA5F177EFA66),
  lcid(0x0409), 
  version(2.1), 
  helpstring("Acme Widget Library")
] 
library Acme 
{
…
}; 

مكتبة معرّف (LIBID)

When the يصدّر عملية converts an تجميع إلى a نوع مكتبة, it preserves the الهوية of the مكتبة. Each uniquely identified تجميع becomes a uniquely identified نوع مكتبة. للتأكد من تفرد، يستخدم عملية التحويل بالاسم، الإصدار، و مفتاح عام من تجميع لإنتاج LIBID.

Specifically, the combination provides the following guarantees:

• الاسم والإصدار، و مفتاح عام تركيبة LIBID نفس تعطي بشكل متناسق.

• الثاني تجميعات مع different اسم, الإصدار, و public المفتاح combinations ‏‏مطلقاً produce the same LIBIDs.

You can يطبق the GuidAttribute إلى بوضوح التعيين the LIBID.

الإصدار و بنية رقم

The تحويل عملية also passes الإصدار معلومات من the تجميع إلى the نوع مكتبة, although نوع مكتبات contain فقط a الثاني-part الإصدار رقم, while تجميعات contain a الرابع-part الإصدار رقم. The رئيسي و ثانوي الإصدار أرقام of an تجميع are carried إعادة توجيه مكالمة إلى the نوع مكتبة. تجميع بنية أرقام are discarded في the تحويل, which indicates that الثاني تجميعات differing فقط بواسطة their بنية أرقام دوماً yield the same نوع مكتبة. تجميعات مع 0 representing the رئيسي و ثانوي أرقام (0.0.X.X) produce a نوع مكتبة مع a 1.0 الإصدار رقم.

في عام, there are لا guarantees حول the المحتويات of a نوع مكتبة generated من multiple تجميع versions. A نوع defined في الإصدار 1.0 of a particular مكتبة ليس guaranteed إلى be في a ثانية الإصدار of the same مكتبة.

إعدادات محلية معلومات

An تجميع's إعدادات محلية معرّف سلسلة (us-en, for مثال) هو محول إلى an LCID و stored في the LCID حقل في the نوع مكتبة. إذا كانت سلسلة معرّف إعدادات محلية هو موجود في تجميع، تقوم عملية التصدير بتعيين معرّف اللغة إلى 0.

فترات إلى سفلية

أسماء التجميعات عادة على فترات زمنية غير مسموح بها في نوع أسماء المكتبة. يصدّر عملية تحويل نقاط في حقل اسم تجميع إلى تسطير أسفل السطر.

Helpstrings

تقوم عملية التصدير بنسخ AssemblyDescriptionAttributeتطبيق تجميع في وقت التصميم، helpstring أو DocString المقترنة نوع المكتبة. الحقل HelpContext في مكتبة النوع ولا الحقل ملف _ تعليمات هو تعيين. عدم وجود أي من LIBFLAGS في مكتبة النوع التعيين.

حقول تجميع غير ذلك

الحقول الأخرى sembly كـ مثل كـ المعالج ، OSInformation CodeBكـe ، Ali كـ أو كـ semblyHكـh و تكوين علامات تجاهلها أثناء عملية تحويل.

تقوم عملية التصدير لا يعين السمات مكتبة نوع, مثل المخفي و مقيد عنصر التحكم.

راجع أيضًا:

المبادئ

تحويل وحدة نمطية? التي تم تصديرها

تحويل نوع المصدر

تحويل العضو الذي تم تصديره

تحويل المعلمات التي تم تصديرها

موارد أخرى

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