مقدمة إلى كائن BuildManager

BuildManagerاستخدام الكائن قبل المطوّرين لجهة خارجية إلى إدارة الملفات التنفيذية محمول (PE). يتم تصنيف ملفات PE من أدوات مخصصة للإشارة في المشروع النظام التي سيتم تحويلها برمجياً PE مؤقتة الإخراج الخاصة بها.

BuildManagerالكائن وأدوات مخصصة تُستخدم في تطوير مصممي مرئية. مصمم في Visual Studioيوفر واجهة مستخدم رسومية على الملف. في ترتيب لإنشاء واجهة المستخدم قد تحتاج المصمم لتكون قادراً على إنشاء مثيل الأنواع الموضحة في ملفات عنصر المشروع. الملفات المؤقتة PE من أدوات مخصصة هي ملفات التجميع التي تغلف أنواع الموصوفة في عناصر المشروع يتم إخراج أداة مخصصة. وبالتالي، مصممي أدوات مخصصة غالباً ما تعمل معاً لإنشاء واجهة المستخدم في وقت التصميم. هو مثال جيد لهذا "أداة مخصصة" التي تنشئ فئات من ملف XSD. يلزم مصممي المرئية أحياناً إنشاء مثيل للفئات التي تم إنشاؤها إلى اكتشاف ما proffered خلال مجموعة البيانات لتوفير واجهة المستخدم لتمكين دعم وقت التصميم ميزات مثل ربط البيانات.

أدوات مخصصة

يأخذ أداة مخصصة مثل الإدخال المحتويات من ملف مشروع العنصر ويقوم بإنشاء ملف مشروع جديد عنصر قد أو قد لا يتم تصنيف فيما بعد. يكون تسلسل نموذجية للأحداث:

1. تعيين المستخدم أو مصمم CustomToolالخاصية مشروع العنصر.

2. تشغيل الأداة مخصصة مع المشروع العنصر محتويات كإدخال. إذا لم يتعرف أداة مخصصة الإدخال التقرير عن الأخطاء كما تم تحديده بواسطة أداة مخصصة للمستخدم. لمزيد من المعلومات، راجع RunCustomTool.

3. يتم تصنيف إخراج الأداة مخصصة مع مراجع المشروع في ملف تنفيذي محمول (PE المؤقتة).

   ملاحظة

   يتم الإخراج المترجمة PE مؤقتة فقط إذا تم تسجيل أداة مخصصة مع GeneratesDesignTimeOutputتعيين القيمة السجل في 1.

4. يتوفر وصف PE عن طريق استدعاء BuildManagerالكائن BuildDesignTimeOutputالأسلوب.

   إخراج PE المؤقتة التي يتم إرجاعها من قبل BuildDesignTimeOutputكما يلي:

   <root>
       <Application private_binpath=”full output path to temporary PE,
   excluding the name”/>
       <Assembly
           codebase = “filename of the temporary PE, e.g., sample.dll””
           name = “name of the temporary PE == filename without the 
   extension, e.g., “sample””
           version = “always “0.0.0.0””
           snapshot_id = “unique ID number” 
           replaceable = “currently unused; always set to “True””
       />
   </root>
   

كائن BuildManager

BuildManagerالكائن وصولاً إلى PEs المؤقتة. DesignTimeOutputMonikersالخاصية عبارة عن صفيف من الكل PE الألقاب (أسماء) في المشروع. يعين النظام المشروع استناداً إلى هيكلي للمشروع الألقاب PE. على سبيل المثال، إذا كان هناك مصمم ملف XML، SomeData.xsd في Folder1 من مشروع1 التي تم إنشاؤها الإخراج SomeData.cs, ثم اللقب ستكون Project1\Folder1\SomeData.cs. BuildDesignTimeOutputأسلوب تأخذ لقب كمعلمة وتقوم بإرجاع وصف PE في سلسلة XML.

BuildManagerEventsClassالكائن DesignTimeOutputDeletedتشغيل الحدث عند مشروع العنصر و تم حذف الملف بإنشاء PE من المشروع. DesignTimeOutputDirtyتشغيل الحدث عند أداة مخصصة (مفرد منشئ الملف) الذي يقوم بإنشاء مؤقتة PE يتم تشغيلها. الكل مفرد يتم تشغيل الملف generators في مشروع عند:

• يتم فتح مشروع فوراً بعد ترقية.

• لقد تم تم تغييره ‏‏مساحة الاسم الجذر.

يتم تشغيل generators ملف مفرد الفردية عند:

• المستند باستخدام مفرد حفظ منشئ الملف (على سبيل المثال، مجموعة بيانات).

• المستند باستخدام مفرد منشئ الملف مفتوح ويتم سيئ و المستخدم بالتبديل إلى مستند آخر ضمن Visual Studio.

• ملف في المشروع باستخدام مفرد إعادة تسمية منشئ الملف أو نقله.

• قام المستخدم symbolically إعادة تسمية نوع استخدامها داخل ملف الإخراج من مفرد منشئ الملف. على سبيل المثال، في حالة استدعاء المستخدم إعادة تسمية رمزي على اكتب 'النوع' "و" المعرف نوع تلك المستخدمة في dataset1.vb (إخراج مجموعة البيانات) ، مفرد يحصل استدعاء منشئ الملف بعد اكتمال عملية إعادة تسمية.

انقر فوق الارتباط الموجود في الجدول التالي للحصول على العرض توضيحي كيف إلى البرنامج باستخدام BuildManagerالكائن.

لعمل	راجع
عرض الألقاب للملفات PE المؤقتة و لمراقبة BuildManagerEvents.	كيفية القيام بما يلي: استخدام BuildManager والكائنات BuildManagerEvents

موردو الجهات الأخرى

مقدار من BuildManagerوظيفة الكائن قد أيضاً يمكن الوصول إليها عبر ITypeResolutionServiceالواجهة. على الرغم من ذلك، يجب أن تستخدم بائعين لجهة أخرى تريد مصمم شاملة DesignTimeOutputMonikersالخاصية و BuildDesignTimeOutputالأسلوب. لمزيد من المعلومات، راجع طيف Visual Studio التنفيذ التلقائي.