إعداد سمات التجميع

سمات التجميع هي قيم توفر معلومات حول التجميع. يتم تقسيم السمات إلى مجموعات المعلومات التالية:

• سمات الهوية للتجميع.

• سمات إعلامية.

• سمات بيان التجميع.

• سمات الاسم القوي.

سمات الهوية للتجميع.

ثلاثة سمات،مقترنة مع الاسم القوي (إن أمكن) ، تحدد هوية التجميع: الاسم , و الإصدار , و الثقافة. هذه السماتت تمثل الاسم الكامل للتجميع و هي مطلوبة عند الإشارة إلى التجميع في التعليمات البرمجية. يمكنك استخدام السمات لتعيين إصدار التجميع و الثقافة. يعين المحول البرمجي أو رابط التجميع (Al.exe) قيمة الاسم عند إنشاء التجميع , بناء على الملف الذي يحتوي على بيان التجميع.

يصف الجدول التالي سمتي الاسم و الثقافة.

سمات الهوية للتجميع.	الوصف
AssemblyCultureAttribute	حقل تعداد يشير إلى الثقافة التي يدعمها التجميع. يمكن أيضاً للتجميع أن يحدد استقلاله عن أي ثقافة , مما يشير إلى أنه يحتوي على الموارد للثقافة الافتراضية. ملاحظة وقت التشغيل يعامل أي تجميع لا يحتوي على سمة الثقافة معينة إلى خالية (null) كتجميع قمر صناعي.مثل هذه التجميعات عُرضة لقواعد ربط تجميع القمر الصناعي.لمزيد من المعلومات ، راجع كيف يحدد وقت التشغيل موقع التجميعات.
AssemblyFlagsAttribute	القيم التي تعين سمات التجميع , مثل ما إذا كان يمكن تشغيل التجميع جنباً إلى جنب.
AssemblyVersionAttribute	قيمة رقمية على الصورة الرئيسية. الثانوية.الإنشاء.المراجعة (على سبيل المثال، 2.4.0.0). وقت تشغيل اللغة العامة يستخدم هذه القيمة لتنفيذ عمليات الربط في التجميعات ذات الاسماء القوية. ملاحظة إذا لم تطبق السمة AssemblyInformationalVersionAttribute على تجميع, رقم الإصدار المحدد بواسطة السمة AssemblyVersionAttribute يستخدم من قِبل الخصائص Application.ProductVersion ، و Application.UserAppDataPath ، و Application.UserAppDataRegistry.

مثال التعليمات البرمجية التالي يوضح كيفية تطبيق سمات الإصدار و الثقافة على تجميع.

'Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
'Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

//Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
//Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

سمات إعلامية.

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

سمة إعلامية.	الوصف
AssemblyCompanyAttribute	سلسلة نصية قيمتها تحدد اسم شركة.
AssemblyCopyrightAttribute	سلسلة نصية قيمتها تحدد معلومات حقوق النشر.
AssemblyFileVersionAttribute	سلسلة نصية قيمتها تحدد رقم إصدار ملف Win32. هذا عادةً يعين افتراضياً لإصدار التجميع.
AssemblyInformationalVersionAttribute	سلسلة نصية قيمتها تحدد معلومات الإصدار الغير مستخدمة من قِبل وقت تشغيل اللغة العامة, مثل قيمة رقم الإصدار الكامل للمنتج. ملاحظة إذا كانت هذه السمة مطبقة على تجميع , السلسلة التي تحددها يمكن الحصول عليها في وقت التشغيل باستخدام الخاصية Application.ProductVersion.تستخدم السلسلة أيضاً في المسار و مفتاح التسجيل الذي توفره الخصائص Application.UserAppDataPath و Application.UserAppDataRegistry.
AssemblyProductAttribute	سلسلة نصية قيمتها تحدد معلومات المنتج.
AssemblyTrademarkAttribute	سلسلة نصية قيمتها تحدد معلومات العلامة التجارية.

يمكن أن تظهر هذه السمات على صفحة خصائص Windows للتجميع , أو يمكن تجاوزها بقيم أخرى باستخدام خيار برنامج التحويل البرمجي / win32res لتحديد ملف مورد Win32 الخاص بك.

سمات بيان التجميع.

يمكنك استخدام سمات بيان التجميع لتوفير معلومات في بيان التجميع , بما في ذلك العنوان,و الوصف,و الاسم المستعار الافتراضي , و التكوين. يصف الجدول التالي سمات بيان التجميع.

سمة بيان التجميع.	الوصف
AssemblyConfigurationAttribute	سلسلة نصية قيمتها توضح تكوين التجميع , مثل التجزئة أو التصحيح. وقت التشغيل لا يستخدم هذاا القيمة.
AssemblyDefaultAliasAttribute	سلسلة نصية قيمتها تحدد الاسم المستعار الافتراضي ليتم استخدامه للرجوع إلى التجميعات. توفر هذه القيمة على اسم مألوف عندما يكون اسم التجميع نفسه غير مألوف (مثل قيمة GUID). يمكن أيضاً استخدام هذه القيمة كصورة قصيرة من اسم التجميع الكامل.
AssemblyDescriptionAttribute	سلسلة نصية قيمتها تحدد وصف موجز يلخص طبيعة و غرض التجميع.
AssemblyTitleAttribute	سلسلة نصية قيمتها تحدد اسم مألوف للتجميع. على سبيل المثال، تجميع يسمى comdlg قد يكون له عنوان عنصر التحكم في مربع الحوار العام لـ Microsoft.

سمات الاسم القوي.

يمكنك استخدام سمات الاسم القوي لتعيين اسم قوي لتجميع. يصف الجدول التالي سمات الاسم القوي.

سمات الاسم القوي.	الوصف
AssemblyDelaySignAttribute	قيمة منطقية تشير إلى أن التوقيع المتأخر قيد الاستخدام.
AssemblyKeyFileAttribute	سلسلة نصية قيمتها تشير إلى اسم الملف الذي يحتوي على المفتاح العام (في حالة استخدام التوقيع المتأخر) أو كلاً من المفتاح العام والخاص ممره كمعلمات لمُنشئ هذه السمة. لاحظ أن اسم الملف نسبي إلى مسار ملف الإخراج (.exe أو .dll) ، و ليس إلى مسار الملف المصدر.
AssemblyKeyNameAttribute	يشير إلى حاوية المفتاح التي تحتوي على زوج المفاتيح التي يتم تمريرها كمعلمة لمُنشئ هذه السمة.

يظهر مثال التعليمات البرمجية التالي السمات التي يمكن تطبيقها عند استخدام التوقيع المتأخر لإنشاء تجميع باسم قوي بملف مفتاح عام يسمى myKey.snk.

      <Assembly:AssemblyKeyFileAttribute("myKey.snk")>
      <Assembly:AssemblyDelaySignAttribute(True)>

      [assembly:AssemblyKeyFileAttribute(@"..\..\myKey.snk")]
      [assembly:AssemblyDelaySignAttribute(true)]

راجع أيضًا:

المبادئ

إنشاء التجميعات

موارد أخرى

البرمجة مع التجميعات