مهمة Vbc
vbc.exe wraps الذي ينتج ملفات تنفيذية (.exe) أو مكتبات إرتباط حيوية (.dll) أو رمز الوحدات النمطية (. netmodule) . للحصول على معلومات أكثر حول LC.exe, راجع المحول البرمجي Visual Basic.
المعلمات
الجدول التالي يصف معلّمات مهمة Vbc .
المعلمة |
الوصف |
---|---|
AdditionalLibPaths |
المعلّمة الإختيارية String[]. تحدد مجلدات إضافية التي فيها يتم البحث عن تجميعات محدّدة في سمة المراجع . |
AddModules |
المعلّمة الإختيارية String[]. يجعل برنامج التحويل البرمجي يقوم بجعل كل أنواع المعلومات من الملفات المحدّدة متوفرة للمشروع الذي تقوم حالياً بترجمته. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/1zbs3z8d(v=vs.100) للمحوّل البرمجي vbc.exe. |
BaseAddress |
المعلّمة الإختيارية String. تعيّن العنوان الأساسي لمكتبة الإرتباط الحيوي (DLL). تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/5td1wkc5(v=vs.100) للمحوّل البرمجي vbc.exe. |
CodePage |
المعلّمة الإختيارية Int32. يحدد صفحة التعليمات البرمجية لاستخدامها في كافة ملفات مصادر التعليمات البرمجية في التحويل البرمجي. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/974213w8(v=vs.100) للمحوّل البرمجي vbc.exe. |
DebugType |
المعلّمة الإختيارية String[]. يجعل برنامج التحويل البرمجي يقوم بتوليد معلومات تصحيح الأخطاء. هذه المعلّمة يمكن أن تأخذ القيم التالية :
القيمة الإفتراضية هي full، والذي يمكن إرفاق مصحح أخطاء إلى البرنامج قيد التشغيل. قيمة pdbonly يسمح تصحيح تعليمات برمجية المصدر عند بدء تشغيل البرنامج في المصحح ولكن يعرض رمز لغة التجميع فقط عندما يتم إرفاق برنامج قيد التشغيل إلى مصحح الأخطاء. لمزيد من المعلومات، راجع / debug (Visual Basic). |
DefineConstants |
المعلّمة الإختيارية String[]. يعرّف ثوابت المترجم البرمجي الشرطي. يتم فصل أزواج الرمز / القيمة بفواصل منقوطة ثم تحدّد ببناء الجملة التالي: symbol1=value1;symbol2=value2 تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/s477hyxw(v=vs.100) للمحوّل البرمجي vbc.exe. |
DelaySign |
المعلّمة الإختيارية Boolean. إذا true، تضع المفتاح العام في التجميع. إذا false، توقع التجميع بشكل كامل. القيمة الإفتراضية هي false . هذه المعلمة لن يكون لها تأثير ما لم يتم استخدامها مع المعلمة KeyFile أو المعلمة KeyContainer. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/6fb81bb5(v=vs.100) للمحوّل البرمجي vbc.exe. |
DisabledWarnings |
المعلّمة الإختيارية String. يمنع التحذيرات المحدّدة. أنت بحاجة فقط إلى تحديد الجزء الرقمي من معرّف التحذير . يتم فصل التحذيرات المتعدّدة بفواصل منقوطة. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/c86sssa5(v=vs.100) للمحوّل البرمجي vbc.exe. |
DocumentationFile |
المعلّمة الإختيارية String. معالجة تعليقات الوثائق على ملف XML المحدد. تتجاوز هذه المعلمة السمة GenerateDocumentation. لمزيد من المعلومات، راجع أو. |
EmitDebugInformation |
المعلّمة الإختيارية Boolean. إذا true، المهمة تقوم بإنشاء معلومات التصحيح ووضعه في ملف pdb.. لمزيد من المعلومات، راجع / debug (Visual Basic). |
ErrorReport |
المعلّمة الإختيارية String. تحديد كيفية قيام المهمة بإرسال تقرير عن أخطاء برنامج التحويل البرمجي الداخلية. هذه المعلّمة يمكن أن تأخذ القيم التالية :
إذا تم تحديد prompt و حدث خطأ داخلي في المحول البرمجي , تتم مطالبة المستخدم باختيار ما إذا كان يريد إرسال معلومات خطأ ل Microsoft. إذا تم تحديد send "و" حدث خطأ داخلي في المترجم, تقوم المهمة بإرسال بيانات خطأ إلى Microsoft. القيمة الإفتراضية هي none، والتي ترسل تقارير الأخطاء في إخراج نص فقط. تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. |
FileAlignment |
المعلّمة الإختيارية Int32. تعيّن، بالبايت، أين سيتم محاذاة مقاطع ملف الإخراج. هذه المعلّمة يمكن أن تأخذ القيم التالية :
تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/wf5kss02(v=vs.100) للمحوّل البرمجي vbc.exe. |
GenerateDocumentation |
المعلّمة الإختيارية Boolean. إذا true، تولّد وثائق المعلومات و تضعه في ملف XML بإسم الملف التنفيذي أو المكتبة التي تقوم المهمة بإنشائها . لمزيد من المعلومات، راجع أو. |
Imports |
المعلّمة الإختيارية ITaskItem[]. يستورد مساحات الأسماء من مجموعات العنصر المحددة. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/64c84czf(v=vs.100) للمحوّل البرمجي vbc.exe. |
KeyContainer |
المعلّمة الإختيارية String. يحدد إسم حاوية مفتاح التشفير. تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. |
KeyFile |
المعلّمة الإختيارية String. يحدد إسم الملف الذي يحتوي على مفتاح التشفير. لمزيد من المعلومات، راجع أو. |
LinkResources |
المعلّمة الإختيارية ITaskItem[]. إنشاء ارتباط إلى مورد .NET Framework في ملف الإخراج; ملف الموارد لن يتم وضعه في ملف الإخراج. تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. العناصر التي تم تمريرها إلى هذه المعلمة يمكن انا يكون لها إدخالات بيانات تعريف إختيارية مسماة LogicalName و Access. LogicalName يتوافق مع إلى الوسيطة identifier للمبدل /linkresource ، و يتوافق Access مع الوسيطة filename. |
MainEntryPoint |
المعلّمة الإختيارية String. يـعين فئة أو وحدة نمطية تحتوي على إجراء Sub Main . تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. |
NoConfig |
المعلّمة الإختيارية Boolean. تعيّن أنه لا يجب على المحول البرمجي إستخدام الملف vbc.rsp. تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. |
NoLogo |
المعلّمة الإختيارية Boolean. إذا true، يمنع عرض معلومات شعار برنامج التحويل البرمجي. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/65ee2y8z(v=vs.100) للمحوّل البرمجي vbc.exe. |
NoStandardLib |
المعلّمة الإختيارية Boolean. يجعل المحول البرمجي لايشير إلى المكتبات القياسية. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/79e7wdtc(v=vs.100) للمحوّل البرمجي vbc.exe. |
NoWarnings |
المعلّمة الإختيارية Boolean. إذا true، المهمة تحذف كل التحذيرات. لمزيد من المعلومات، راجع أو. |
Optimize |
المعلّمة الإختيارية Boolean. إذا true، يتيح أمثلية برنامج التحويل البرمجي. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/yf8493s5(v=vs.100) للمحوّل البرمجي vbc.exe. |
OptionCompare |
المعلّمة الإختيارية String. تحديد كيفية إجراء المقارنات بين السلاسل. هذه المعلّمة يمكن أن تأخذ القيم التالية :
القيمة binary تعيّن أن المهمة تستخدم مقارنة سلسلة أحرف ثنائية. القيمة text تعيّن أن المهمة تستخدم مقارنة سلسلة أحرف ثنائية. القيمة الإفتراضية لهذه المعلمة هي binary. تتوافق هذه المعلّمة مع المبدّل /errorreport للمحوّل البرمجي vbc.exe. |
OptionExplicit |
المعلّمة الإختيارية Boolean. إذا true، مطلوب تعريف صريح للمتغيرات. تتوافق هذه المعلّمة مع المبدّل /optionexplicit للمحوّل البرمجي vbc.exe. |
OptionStrict |
المعلّمة الإختيارية Boolean. إذا true، المهمة تفرض دلالات نوع الصارمة لتقييد تحويلات نوع ضمنية. تتوافق هذه المعلّمة مع المبدّل /optionstrict للمحوّل البرمجي vbc.exe. |
OutputAssembly |
معلّمة الإخراج الإختيارية String . تعيّن إسم ملف الإخراج. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/std9609e(v=vs.100) للمحوّل البرمجي vbc.exe. |
Platform |
المعلّمة الإختيارية String. تحدّد النظام الأساسي للمعالج الذي سيتم إستهدافه بواسطة ملف الإخراج. هذه المعلمة يمكن أن تأخذ قيمة x86, x64, Itanium، أو anycpu. القيمة الافتراضية هي anycpu. تتوافق هذه المعلّمة مع المبدّل /platform للمحوّل البرمجي vbc.exe. |
References |
المعلّمة الإختيارية ITaskItem[]. يجعل المهمة تستورد معلومات النوع العام من العناصر المحددة إلى المشروع الحالي. تتوافق هذه المعلّمة مع المبدّل /reference للمحوّل البرمجي vbc.exe. |
RemoveIntegerChecks |
المعلّمة الإختيارية Boolean. إذا true، تعطل تدقيق خطأ تجاوز عدد صحيح. القيمة الافتراضية هي false. تتوافق هذه المعلّمة مع المبدّل/removeintchecks للمحوّل البرمجي vbc.exe. |
Resources |
المعلّمة الإختيارية ITaskItem[]. يضمّّن مورد .NET Framework في ملف الإخراج. تتوافق هذه المعلّمة مع المبدّل https://msdn.microsoft.com/ar-sa/library/d2910c0e(v=vs.100) للمحوّل البرمجي vbc.exe. العناصر التي تم تمريرها إلى هذه المعلمة يمكن انا يكون لها إدخالات بيانات تعريف إختيارية مسماة LogicalName و Access. LogicalName تتوافق مع المعلمة identifier للمبدل /resource و Access تتوافق مع المعلمة filename . |
ResponseFiles |
المعلّمة الإختيارية ITaskItem[]. يحدّد ملف الإستجابة الذي يحتوي على الأوامر لهذه المهمة. تتوافق هذه المعلمة إلى خيار @ (Specify Response File) المترجم vbc.exe. |
RootNamespace |
المعلّمة الإختيارية String. تعيّن مساحة إسم الجذر لكل تعريفات الأنواع. تتوافق هذه المعلّمة مع المبدّل /rootnamespace للمحوّل البرمجي vbc.exe. |
SdkPath |
المعلّمة الإختيارية String. تحدّد موقع mscorlib.dll و microsoft.visualbasic.dll. تتوافق هذه المعلّمة مع المبدّل /sdkpath للمحوّل البرمجي vbc.exe. |
Sources |
المعلّمة الإختيارية ITaskItem[]. تحدد واحد أو أكثر من ملفات المصدر Visual Basic. |
TargetCompactFramework |
المعلّمة الإختيارية Boolean. إذا true، مهمة تستهدف .NET Compact Framework. تتوافق هذه المعلّمة مع المبدّل /netcf للمحوّل البرمجي vbc.exe. |
TargetType |
المعلّمة الإختيارية String. تعيّن تنسيق الملف لملف الإخراج . هذه المعلمة يمكن أن تأخذ القيمة library، الذي يقوم بإنشاء مكتبة تعليمات برمجية، exe، الذي يقوم بإنشاء أحد تطبيقات وحدة تحكم module، الذي يقوم بإنشاء وحدة نمطية أو winexe، الذي يقوم بإنشاء برنامج Windows. القيمة الافتراضية هي library. تتوافق هذه المعلّمة مع المبدّل /target للمحوّل البرمجي vbc.exe. |
Timeout |
المعلّمة الإختيارية Int32. تعيّن مقدار الوقت، بالميللي ثانية، الذي بعده يتم إنهاء المهمة القابلة للتنفيذ . القيمة الإفتراضية هي Int.MaxValue، التي تشير إلى أنه لا يوجد وقت مهلة. |
ToolPath |
المعلّمة الإختيارية String. تحدّد الموقع الذي منه ستقوم المهمة بتحميل الملف الأساسي القابل للتنفيذ (VCBuild.exe). إذا لم يتم تحديد هذه المعلّمة, تستخدم المهمة مسار تثبيت SDK المطابق لإصدار إطار العمل الذي يقوم بتشغيل MSBuild. |
TreatWarningsAsErrors |
المعلّمة الإختيارية Boolean. إذا true، كل التحذيرات تعامل على أنها أخطاء. لمزيد من المعلومات، راجع /warnaserror (Visual Basic). |
UseHostCompilerIfAvailable |
المعلّمة الإختيارية Boolean. يرشد المهمة إلى إستخدام الكائن قيد التشغيل الخاص ببرنامج التحويل البرمجي إذا كان متوفر. يستخدمها فقط Visual Studio. |
Utf8Output |
المعلّمة الإختيارية Boolean. يسجل مخرجات برنامج التحويل البرمجي باستخدام ترميز UTF-8. تتوافق هذه المعلّمة مع المبدّل /utf8output للمحوّل البرمجي vbc.exe. |
Verbosity |
المعلّمة الإختيارية String. تعيّن ال verbosity لمخرج برنامج التحويل البرمجي . يمكن أن يكون verbosity Quiet, Normal (الافتراضي) ، أو Verbose. |
WarningsAsErrors |
المعلّمة الإختيارية String. تعيّن قائمة من التحذيرات ليتم معاملتها كأخطاء . لمزيد من المعلومات، راجع /warnaserror (Visual Basic). تتجاوز هذه المعلمة المعلمة TreatWarningsAsErrors. |
WarningsNotAsErrors |
المعلّمة الإختيارية String. تعيّن قائمة من التحذيرات التي لا تعامل على أنها أخطاء. لمزيد من المعلومات، راجع /warnaserror (Visual Basic). هذه المعلمة مفيدة فقط إذا تم تعيين المعلمة TreatWarningsAsErrors إلى true. |
Win32Icon |
المعلّمة الإختيارية String. يقوم بإدراج ملف .ico في التجميع الذي يعطي ملف الإخراج المظهر المطلوب في مستكشف Windows. تتوافق هذه المعلّمة مع المبدّل /win32icon للمحوّل البرمجي vbc.exe. |
Win32Resources |
المعلّمة الإختيارية String. يدرج ملف مورد (Win32 (.res في ملف الإخراج . تتوافق هذه المعلّمة مع المبدّل /win32resource للمحوّل البرمجي vbc.exe. |
مثال
المثال التالي يترجم مشروع Visual Basic.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>