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

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

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

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

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

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

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

ثلاثة سمات،مقترنة مع الاسم القوي (إن أمكن) ، تحدد هوية التجميع: الاسم , و الإصدار , و الثقافة. هذه السماتت تمثل الاسم الكامل للتجميع و هي مطلوبة عند الإشارة إلى التجميع في التعليمات البرمجية. يمكنك استخدام السمات لتعيين إصدار التجميع و الثقافة. يعين المحول البرمجي أو رابط التجميع (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 الخاص بك.

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

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

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

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

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

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

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

راجع أيضًا:

المبادئ

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

موارد أخرى

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