مشاركة عبر

مهمة Csc

  • مقالة

تلف CSC.exe وتنشىء الملفات القابلة للتنفيذ (ملفات exe.) , مكتبات ارتباط حيوية (ملفات dll.) أو الوحدات النمطية للرمز (. ملفات netmodule). لمزيد من المعلومات حول CSC.exe راجع (خيارات المحول البرمجي #C).

المعلمات

الجدول التالي يصف معلّمات مهمة Csc .

المعلمة

الوصف

AdditionalLibPaths

المعلّمة الإختيارية String[].

تحدد الدلائل الإضافية التي سيتم فيها البحث عن مراجع. لمزيد من المعلومات، راجع /lib (خيارات المحول البرمجي C#).

AddModules

المعلّمة الإختيارية String.

يحدد واحد أو أكثر من الوحدات النمطية لتكون جزءاً من التجميع. لمزيد من المعلومات، راجع /addmodule (خيارات المحول البرمجي C#).

AllowUnsafeBlocks

المعلّمة الإختيارية Boolean.

إذا true، يترجم التعليمات البرمجية التي تستخدم الكلمة الأساسية unsafe. لمزيد من المعلومات، راجع /unsafe (خيارات المحول البرمجي C#).

BaseAddress

المعلّمة الإختيارية String.

يحدد العنوان الأساسي المفضل الذي يتم فيه تحميل DLL. يعيين العنوان الأساسي الافتراضي ل DLL بواسطة.NET Framework وقت تشغيل اللغة العامة. لمزيد من المعلومات، راجع /baseaddress (خيارات المحول البرمجي C#).

CheckForOverflowUnderflow

المعلّمة الإختيارية Boolean.

يحدد ما إذا كان حساب العدد الصحيح الذي يخرج عن حدود إطار نوع البيانات يؤدي إلى حدوث استثناء عند وقت التشغيل. لمزيد من المعلومات، راجع /checked (خيارات المحول البرمجي C#).

CodePage

المعلّمة الإختيارية Int32.

يحدد صفحة التعليمات البرمجية لاستخدامها في كافة ملفات مصادر التعليمات البرمجية في التحويل البرمجي. لمزيد من المعلومات، راجع /codepage (خيارات المحول البرمجي C#).

DebugType

المعلّمة الإختيارية String.

تحدد نوع التصحيح. يمكن أن يكون DebugType, full,أو pdbonly . الافتراضي هو full، والذي يمكّن من إرفاق مصحح الأخطاء إلى برنامج قيد تشغيل. تحديد pdbonlyيسمح بتصحيح أخطاء التعليمات البرمجية للمصدر عند بدء البرنامج في مصحح الأخطاء ولكن سيتم عرض المجمّع فقط عند إرفاق البرنامج قيد التشغيل إلى مصحح الأخطاء.

تتجاوز هذه المعلمة المعلمة EmitDebugInformation.

لمزيد من المعلومات، راجع /debug (خيارات المحول البرمجي C#).

DefineConstants

المعلّمة الإختيارية String.

يعرّف رموز المعالج الأولي. لمزيد من المعلومات، راجع / define (خيارات المحول البرمجي C#).

DelaySign

المعلّمة الإختيارية Boolean.

إذا true، تحدد أنك تريد تجميع موقع بشكل كامل. اذا false تحدد انك تريد فقط وضع المفتاح العام في التجميع.

هذه المعلمة لا تأثير لها ما لم يتم استخدامها مع إما المعلمة KeyFile أو المعلمة KeyContainer.

لمزيد من المعلومات، راجع /delaysign (خيارات المحول البرمجي C#).

DisabledWarnings

المعلّمة الإختيارية String.

تعيّن قائمة التحذيرات التي سيتم تعطيلها. لمزيد من المعلومات، راجع /nowarn (خيارات المحول البرمجي C#).

DocumentationFile

المعلّمة الإختيارية String.

تعالج تعليقات الوثائق لملف XML. لمزيد من المعلومات، راجع /doc (خيارات المحول البرمجي# C).

EmitDebugInformation

المعلّمة الإختيارية Boolean.

إذا true، المهمة تقوم بإنشاء معلومات التصحيح ووضعها في ملف قاعدة بيانات البرنامج (pdb.). إذا false، المهمة تتجاهل أية معلومات غير معلومات التصحيح. القيمة الافتراضية هي false. لمزيد من المعلومات، راجع /debug (خيارات المحول البرمجي C#).

ErrorReport

المعلّمة الإختيارية String.

يوفر طريقة ملائمة لإرسال تقرير عن خطأ #C داخلي إلى Microsoft. هذه المعلمة يمكن أن تأخذ قيمة prompt, send, أو none . إذا تم تعيين المعلمة إلى prompt، ستتلقى مطالبة عند حدوث خطأ في المترجم داخلي. المطالبة تجعلك تقوم بارسال تقرير خطأ إلكنروني إلى Microsoft. إذا تم تعيين المعلمة إلى send، يتم إرسال تقرير الشوائب تلقائياً. إذا تم تعيين المعلمة إلى none، يتم الإعلام عن الخطأ فقط في إخراج النص للمحول البرمجي. القيمة الافتراضية هي none. لمزيد من المعلومات، راجع /errorreport (خيارات المحول البرمجي C#).

FileAlignment

المعلّمة الإختيارية Int32.

يعيّن حجم المقاطع في ملف الإخراج. لمزيد من المعلومات، راجع /filealign (خيارات المحول البرمجي #C ).

GenerateFullPaths

المعلّمة الإختيارية Boolean.

إذا true يحدد المسار المطلق للملف في ناتج برنامج التحويل البرمجي. إذا false تحدد إسم الملف. القيمة الافتراضية هي false. لمزيد من المعلومات، راجع /fullpaths (خيارات المحول البرمجي #C).

KeyContainer

المعلّمة الإختيارية String.

يحدد إسم حاوية مفتاح التشفير. لمزيد من المعلومات، راجع /keycontainer (خيارات المحول البرمجي C#).

KeyFile

المعلّمة الإختيارية String.

يحدد إسم الملف الذي يحتوي على مفتاح التشفير. لمزيد من المعلومات، راجع /keyfile ( خيارات المحوّل البرمجي C#).

LangVersion

المعلّمة الإختيارية String.

يحدد إصدار اللغة للاستخدام. لمزيد من المعلومات، راجع /langversion (خيارات المحوّل البرمجي C# ).

LinkResources

المعلّمة الإختيارية ITaskItem[].

يقوم بإنشاء ارتباط إلى المورد .NET Framework في ملف الإخراج; لا يتم وضع ملف المورد في ملف الإخراج.

العناصر التي تم تمريرها إلى هذه المعلمة يمكن انا يكون لها إدخالات بيانات تعريف إختيارية مسماة LogicalName و Access. LogicalName تتوافق مع المعلمة identifier للمبدل /linkresource و Access تتوافق مع المعلمة accessibility-modifier . لمزيد من المعلومات، راجع /linkresource (خيارات المحول البرمجي C#).

MainEntryPoint

المعلّمة الإختيارية String.

تحدد موقع الأسلوب Main. لمزيد من المعلومات، راجع /main (خيارات المحول البرمجي C#).

NoConfig

المعلّمة الإختيارية Boolean.

إذا true، يخبر المحول البرمجي أن لا يترجم مع ملف csc.rsp . لمزيد من المعلومات، راجع /noconfig (خيارات المحول البرمجي C#).

NoLogo

المعلّمة الإختيارية Boolean.

إذا true، يمنع عرض معلومات شعار برنامج التحويل البرمجي. لمزيد من المعلومات، راجع /nologo ( خيارات المحول البرمجي #C).

NoStandardLib

المعلّمة الإختيارية Boolean.

إذا true يمنع استيراد mscorlib.dll ، والذي يعرّف مساحة اسم Sysem بأكملها. استخدم هذه المعلمة إذا كنت تريد تعريف أو إنشاء مساحة اسم وكائنات System الخاصة بك. لمزيد من المعلومات، راجع /nostdlib (خيارات المحول البرمجي C#).

Optimize

المعلّمة الإختيارية Boolean.

اذاtrue، يتيح الأمثلية. إذا false،يقوم بتعطيل الأمثلية. لمزيد من المعلومات، راجع /optimize (خيارات المحول البرمجي #C).

OutputAssembly

معلّمة الإخراج الإختيارية String .

تعيين اسم لملف الإخراج. لمزيد من المعلومات، راجع /out (خيارات المحوّل البرمجي C#).

Platform

المعلّمة الإختيارية String.

تحدّد النظام الأساسي للمعالج الذي سيتم إستهدافه بواسطة ملف الإخراج. هذه المعلمة يمكن أن تأخذ قيمة x86, x64, أو anycpu . القيمة الافتراضية هي anycpu. لمزيد من المعلومات، راجع /platform (خيارات المحول البرمجي C#).

References

المعلّمة الإختيارية ITaskItem[].

يجعل المهمة تستورد معلومات النوع العام من العناصر المحددة إلى المشروع الحالي. لمزيد من المعلومات، راجع /reference (خيارات المحول البرمجي #C).

يمكنك تحديد الإسم المستعار للمرجع #Visual C في ملف MSBuild عن طريق إضافة بيانات التعريف Aliases إلى العنصر "المرجع" الأصلي. على سبيل المثال، لتعيين الاسم المستعار "LS1" في خط الأوامر CSC التالي:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

يمكنك استخدام:

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

Resources

المعلّمة الإختيارية ITaskItem[].

يضمّن المورد .NET Framework في ملف الإخراج.

العناصر التي تم تمريرها إلى هذه المعلمة يمكن انا يكون لها إدخالات بيانات تعريف إختيارية مسماة LogicalName و Access. LogicalName تتوافق مع المعلمة identifier للمبدل /resource و Access تتوافق مع المعلمة accessibility-modifier . لمزيد من المعلومات، راجع /resource (خيارات المحول البرمجي #C).

ResponseFiles

المعلّمة الإختيارية String.

يحدّد ملف الإستجابة الذي يحتوي على الأوامر لهذه المهمة. لمزيد من المعلومات، راجع @ (خيارات المحول البرمجي C#).

Sources

المعلّمة الإختيارية ITaskItem[].

تحدد واحد أو أكثر من ملفات المصدر #Visual C.

TargetType

المعلّمة الإختيارية String.

تعيّن تنسيق الملف لملف الإخراج . هذه المعلمة يمكن أن تأخذ القيمة library، الذي يقوم بإنشاء مكتبة تعليمات برمجية، exe، الذي يقوم بإنشاء أحد تطبيقات وحدة تحكم module، الذي يقوم بإنشاء وحدة نمطية أو winexe، الذي يقوم بإنشاء برنامج Windows. القيمة الافتراضية هي library. لمزيد من المعلومات، راجع /target (خيارات المحول البرمجي #C).

Timeout

المعلّمة الإختيارية Int32.

تعيّن مقدار الوقت، بالميللي ثانية، الذي بعده يتم إنهاء المهمة القابلة للتنفيذ . القيمة الإفتراضية هي Int.MaxValue، التي تشير إلى أنه لا يوجد وقت مهلة.

ToolPath

المعلّمة الإختيارية String.

تحديد الموقع التي تحمل منه مهمة الملف الأساسي القابل للتنفيذ (CSC.exe). إذا لم يتم تحديد هذه المعلّمة, تستخدم المهمة مسار تثبيت SDK المطابق لإصدار إطار العمل الذي يقوم بتشغيل MSBuild.

TreatWarningsAsErrors

المعلّمة الإختيارية Boolean.

إذا true, تعامل كل التحذيرات كأخطاء. لمزيد من المعلومات، راجع /warnaserror (خيارات المحول البرمجي #C ).

UseHostCompilerIfAvailable

المعلّمة الإختيارية Boolean.

يرشد المهمة إلى إستخدام الكائن قيد التشغيل الخاص ببرنامج التحويل البرمجي إذا كان متوفر. يستخدمها فقط Visual Studio.

Utf8Output

المعلّمة الإختيارية Boolean.

يسجل مخرجات برنامج التحويل البرمجي باستخدام ترميز UTF-8. لمزيد من المعلومات، راجع /utf8output ( خيارات المحول البرمجي C#).

WarningLevel

المعلّمة الإختيارية Int32.

يحدد مستوى التحذير للمحول البرمجي ليتم عرضها. لمزيد من المعلومات، راجع /warn (خيارات المحول البرمجي #C).

WarningsAsErrors

المعلّمة الإختيارية String.

تعيّن قائمة من التحذيرات ليتم معاملتها كأخطاء . لمزيد من المعلومات، راجع /warnaserror (خيارات المحول البرمجي #C ).

تتجاوز هذه المعلمة المعلمة TreatWarningsAsErrors.

WarningsNotAsErrors

المعلّمة الإختيارية String.

تعيّن قائمة من التحذيرات التي لا تعامل على أنها أخطاء. لمزيد من المعلومات، راجع /warnaserror (خيارات المحول البرمجي #C ).

هذه المعلمة مفيدة فقط إذا تم تعيين المعلمة TreatWarningsAsErrors إلى true.

WarningLevel

المعلّمة الإختيارية Int32.

تعين مستوى التحذير المناسب من 0-4. لمزيد من المعلومات، راجع /warn (خيارات المحول البرمجي #C).

Win32Icon

المعلّمة الإختيارية String.

يقوم بإدراج ملف .ico في التجميع الذي يعطي ملف الإخراج المظهر المطلوب في مستكشف Windows. لمزيد من المعلومات، راجع /win32icon ( خيارات المحول البرمجي C# ).

Win32Resource

المعلّمة الإختيارية String.

يدرج ملف مورد (Win32 (.res في ملف الإخراج . لمزيد من المعلومات، راجع /win32res (خيارات المحول البرمجي C# ).

مثال

يستخدم المثال التالي المهمة Csc لترجمة الملفات القابلة للتنفيذ من ملفات المصدر في مجموعة العنصر Compile.

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

راجع أيضًا:

المبادئ

مهام ‏‫MSBuild

موارد أخرى

مرجع مهمة ‏‫MSBuild