إنشاء سطر الأوامر باستخدام csc.exe

يمكنك استدعاء المحول البرمجي#C بكتابة اسم الملف القابل للتنفيذ الخاص به (csc.exe) في سطر الأوامر. إذا كنت تستخدم موجه الأوامر في Visual Studio (متوفر كاختصار في القائمة "ابدأ" ضمن أدوات Visual Studio) ، يتم تعيين كافة متغيرات البيئة الضرورية لك. وإلا، عليك ضبط المسار الخاص بك لتمكين csc.exe من أن يتم استدعاؤه من أي دليل فرعي على جهاز الكمبيوتر الخاص بك. إذا لم تكن تريد استخدام موجه الأوامر Visual Studio , يجب تشغيل vsvars32.bat لتعيين متغيرات البيئة المناسبة لدعم بنيات سطر الأوامر. للحصول على المزيد من المعلومات حول vsvars32.bat ، راجع كيفية القيام بما يلي: تعيين متغيّرات البيئة.

إذا كنت تعمل على كمبيوتر عليه فقط عدة تطوير برامج Windows (SDK) ، يمكنك استخدام مترجم C# في سطر الأوامر في حالة استخدام موجه الأوامر SDK ، الذي يتوفر من خيار القائمة Microsoft .NET Framework SDK.

للإنشاء من بيئة التطوير, راجع كيفية: تحضير للبنيات وإدارتها.

يمكنك أيضاً استخدام MSBuild لإنشاء برامج#C برمجياً. لمزيد من المعلومات، راجع MSBuild.

الملف القايل للتنفيذ csc.exe موجود عادة في المجلد Microsoft.NET\Framework\ < الإصدار > تحت دليل النظام. قد يختلف موقعه اعتماداً على التكوين المحدد على أي كمبيوتر فردي. تكون إصدارات متعددة من هذا الملف القابل للتنفيذ موجودة على الكمبيوتر إذا كان هناك أكثر من إصدار من .NET Framework مثبتا على جهاز الكمبيوتر. للحصول على المزيد من المعلومات حول عمليات التثبيت هذه, راجع تثبيت إصدارات متعددة من برنامج .NET Framework.

هذا الموضوع يغطي التالي:

قواعد بناء جملة سطر الأوامر

نموذج سطور الأوامر

الفروق بين خارج المحول البرمجي #C و المحول البرمجي ++C

قواعد بناء جملة سطر الأوامر لـ المحول البرمجي# C

برنامج التحويل البرمجي #C يستخدم القواعد التالية عندما يفسر الوسيطات المعطاة على سطر أوامر نظام التشغيل:

• الوسائط محدودة عن طريق المسافة البيضاء وهي مسافة أو علامة جدولة.

• حرف الإقحام (^) لا يتم التعرف عليه كحرف هروب أو محدد. تتم معالجة الأحرف من قبل محلل سطر الأوامر في نظام التشغيل قبل أن يتم تمريرها إلى مصفوفة argv في البرنامج.

• السلسلة المحاطة بعلامات اقتباس مزدوجة ("string") يتم تفسيرها كوسيطة مفردة بغض النظر عن المسافة البيضاء المضمنة. يمكن تضمين سلسلة مقتبسة في وسيطة.

• علامة الاقتباس المزدوجة مسبوقة بخط مائل عكسي (\ ") يتم تفسيرها كحرف علامة اقتباس مزدوجة ('').

• الخطوط المائلة العكسية يتم تفسيرها حرفياً ، إلا إذا سبقت مباشرة علامة اقتباس مزدوجة.

• إذا كان رقما زوحيا من الخطوط المائلة العكسية متبوعاً بعلامة اقتباس مزدوجة, يتم وضع خط مائل عكسي واحد في مصفوفة argv لكل زوج من الخطوط المائلة العكسية , و يتم تفسير علامة الاقتباس المزدوجة كمحدد سلسلة.

• إذا كان رقما فرديا من الخطوط المائلة العكسية متبوعاً بعلامة اقتباس مزدوجة, يتم وضع خط مائل عكسي واحد في مصفوفة argv لكل زوج من الخطوط المائلة العكسية , و علامة الاقتباس المزدوجة يتم تجاوزها مع الخط المائل العكسي المتبقي. يؤدي هذا بعلامة الاقتباس الزوجية الحرفية ('') أن تتم إضافتها إلى argv.

نموذج لسطور الأوامر للمحول البرمجي C#‎

• يحوّل برمجيا File.cs منتجا File.exe:

  csc File.cs 
  

• يحوّل برمجيا File.cs منتجا File.dll:

  csc /target:library File.cs
  

• يحوّل برمجيًا File.cs و ينشئ My.exe:

  csc /out:My.exe File.cs
  

• يحوّل برمجيًا كافة ملفات #C في الدليل الحالي مع التحسينات و يقوم بتعريف رمز التصحيح. الناتج هو File2.exe:

  csc /define:DEBUG /optimize /out:File2.exe *.cs
  

• يحوّل برمجيًا كافة ملفات C# الموجودة في الدليل الحالي منتجاً إصدار تصحيح File2.dll. لا يتم عرض أي شعار أو تحذيرات:

  csc /target:library /out:File2.dll /warn:0 /nologo /debug *.cs
  

• يحوّل برمجيًا كافة ملفات #C في الدليل الحالي إلى Something.xyz (DLL):

  csc /target:library /out:Something.xyz *.cs
  

الفروق بين خارج المحول البرمجي #C و المحول البرمجي ++C

لا توجد أية ملفات كائن (obj.) منشأة نتيجة استدعاء المترجم C# ; يتم إنشاء الملفات المخرجة مباشرةً. كنتيجة لذلك، برنامج التحويل البرمجي C# لا يحتاج إلى رابط.

راجع أيضًا:

المرجع

خيارات المحوّل البرمجي C# المسرودة أبجديًا

خيارات المحول البرمجي C# المسرودة بواسطة الفئة

موارد أخرى

(خيارات المحول البرمجي #C)