مهمة MarkupCompilePass2

تقوم مهمة MarkupCompilePass2 بتنفيذ عملية ترجمة علامات ذات إمرار ثاني على ملفات Extensible Application Markup Language (XAML) ذات النوع مرجع من نفس المشروع.

معلّمات المهمة

المعلمة	الوصف
AlwaysCompileMarkupFilesInSeparateDomain	المعلمة الإختيارية قيمة منطقية. تحديد ما إذا كان سيتم تشغيل المهمة في AppDomain منفصل. إذا رجّعت هذه المعلمة false سيتم تشغيل المهمة في نفس AppDomain كـ Microsoft build engine (MSBuild) وبشكل أسرع. إذا كانت معلمة ترجع صواب المهمة تعمل في ثانية AppDomain معزولة عن MSBuild و تعمل أبطأ.
AssembliesGeneratedDuringBuild	المعلمة الإختيارية سلسلة. تعيّن المراجع إلى التجميعات التي تتغير أثناء عملية البناء. على سبيل المثال، الحل Microsoft Visual Studio 2005 قد يحتوي على مشروع واحد الذي يرجع إلى الإخراج المترجم من مشروع آخر. في هذه الحالة، يمكن إضافة الإخراج المترجم من المشروع الثاني إلى AssembliesGeneratedDuringBuild. ملاحظة: يجب أن تحتوي AssembliesGeneratedDuringBuild على مراجع إلى مجموعة كاملة من تجميعات تم إنشاؤها بواسطة بناء حل معين.
AssemblyName	المعلّمة المطلوبة String. تعيّن الاسم القصير للتجميع الذي يتم إنشاؤه لمشروع. على سبيل المثال، إذا قام المشروع بتوليد Microsoft Windows القابل للتنفيذ ذو الإسم WinExeAssembly.exe , تأخذ المعلّمة AssemblyName القيمة WinExeAssembly.
GeneratedBaml	معلمة الإخراج الإختيارية [] ITaskItem. يحتوي على قائمة الملفات التي تم إنشاؤها في التنسيق الثنائي XAML.
KnownReferencePaths	المعلمة الإختيارية سلسلة. تعيّن مراجع إلى تجميعات لا تتغير أثناء عملية البناء. تتضمن تجميعات الموجودة في مخزن التجميع العمومي المؤقت (GAC)، في دليل التثبيت Microsoft NET Framewor. وما إلى ذلك.
Language	المعلّمة المطلوبة String. تحدّد اللغة المدارة التي يدعمها المحوّل البرمجي. الخيارات الصالحة هي C#‎, VB, JScript, J#, and c++‎.
LocalizationDirectivesToLocFile	المعلمة الإختيارية سلسلة. تحدد كيفية إنشاء معلومات ترجمة بالنسبة لكل ملف مصدر XAML. الخيارات الصالحة هي None, CommentsOnly, and All.
OutputPath	المعلّمة المطلوبة String. تعيّن الدليل الذي يتم إنشاء الملفات ذات التنسيق الثنائي XAML المنشأة فيه.
OutputType	المعلّمة المطلوبة String. تعيّن نوع التجميع الذي يتم إنشاؤه بواسطة أحد المشاريع. الخيارات الصالحة هي winexe, exe, library, netmodule.
References	المعلّمة الاختيارية [] ITaskItem. تعيّن قائمة مراجع من ملفات إلى تجميعات التي تحتوي على الأنواع المستخدمة في الملفات XAML. أحد المراجع إلى التجميع الذي تم إنشاؤه بواسطة المهمة GenerateTemporaryTargetAssembly والتي يجب تشغيلها قبل المهمة MarkupCompilePass2.
RootNamespace	المعلمة الإختيارية سلسلة. تحدد جذر مساحة الاسم للفئات التي تكون داخل المشروع. RootNamespace يتم أيضا استخدامها كمساحة الإسم الإفتراضية لملف تعليمات برمجية مدار عندما لا يحتوي ملف XAML المطابق على السمة x:Class.
XAMLDebuggingInformation	المعلمة الإختيارية قيمة منطقية. إذا صواب يتم إنشاء معلومات التشخيص و تضمينها في XAML المترجم للمساعدة في تصحيح الأخطاء.

ملاحظات

قبل تشغيل MarkupCompilePass2، يجب إنشاء تجميع مؤقت يحتوي على أنواع يتم استخدامها بواسطة ملفات XAML التي تم تأجيل مرور ترجمة العلامات لها. تقوم بإنشاء التجميع المؤقت عن طريق تشغيل المهمة GenerateTemporaryTargetAssembly.

يتم توفير مرجع إلى التجميع المؤقت المنشأ إلى MarkupCompilePass2 عند تشغيله، مع السماح لملفات XAML التي تم تأجيل ترجمتها في المرور الأول لترجمة العلامات إلى الآن يمكن ترجمتها إلى تنسيق ثنائي.

مثال

يوضح المثال التالي كيفية استخدام المهمة MarkupCompilePass2 لإجراء مرور ثاني للترجمة.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask 
    TaskName="Microsoft.Build.Tasks.Windows.MarkupCompilePass2" 
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="MarkupCompilePass2Task">
    <MarkupCompilePass2 
      AssemblyName="WPFMSBuildSample"
      Language="C#"
      OutputType="WinExe"
      OutputPath="obj\Debug\"
      References=".\obj\debug\WPFMSBuildSample.exe;c:\windows\Microsoft.net\Framework\v2.0.50727\System.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationCore.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationFramework.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\WindowsBase.dll" />
  </Target>
</Project>

راجع أيضًا:

المبادئ

إنشاء تطبيق WPF (WPF)

نظرة عامة عرض تقديمي البنية الأساسية لعرض برامج XAML المستعرض تطبيقات حول Windows

موارد أخرى

مرجع ‏‫MSBuild WPF

مرجع مهمة ‏‫MSBuild WPF

مرجع ‏‫MSBuild

مرجع مهمة ‏‫MSBuild