عنصر <compiler>

يحدّد سمات تكوين المحول البرمجي لموفر اللغة.

عنصر <configuration>
  عنصر <system.codedom>
    عنصر <compilers>
      عنصر <compiler>

<compiler
  language="languageName[;...;...]"
  extension="fileExtension[;...;...]"
  type="typeName, assemblyName"
  warningLevel="number"
  compilerOptions="option1 option2"
/>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة	الوصف
compilerOptions	السمة الاختيارية تحدّد وسائط إضافية خاصة ببرنامج التحويل البرمجي للتحويل البرمجي. يتم سرد قيم السمة compilerOptions في موضوع خيارات برنامج التحويل البرمجي للمحول البرمجي. في وثائق ‏‫‏‫Visual Studio 2005 يمكنك تحديد موقع خيارات المحوّل البرمجي من خلال البحث عن "compiler options" في الفهرس.
extension	سمة مطلوبة. يوفر قائمة من ملحقات أسماء الملفات مفصولة بفواصل منقوطة المستخدمة من قبل ملفات المصدر لموفّر اللغة. على سبيل المثال، "cs."
language	سمة مطلوبة. يوفر قائمة من أسماء اللغة المفصولة بفواصل منقوطة المعتمدة من قبل موفر اللغة. على سبيل المثال، "c# cs; csharp".
type	سمة مطلوبة. تعيّن اسم نوع موفر اللغة بما في ذلك اسم التجميع الذي يحتوي على تطبيق الموفر. اسم النوع يجب أن يفي بالمتطلبات المعرفة في Specifying Fully Qualified Type Names.
warningLevel	السمة الاختيارية تحدّد مستوى تحذير برنامج التحويل البرمجي الافتراضي; يحدّد المستوى الذي عنده يعامل موفّر اللغة تحذيرات المحوّل البرمجي كأخطاء.

العناصر التابعة

العنصر	الوصف
عنصر <providerOption>	تحدّد سمات إصدار المترجم لموفّر اللغة.

العناصر الأصلية

العنصر	الوصف
عنصر <configuration>	العنصر الجذري في كل ملف تكوين المستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.
عنصر <system.codedom>	تحدّد خصائص تكوين المحوّل البرمجي لموفري اللغة المتوفرين.
عنصر <compilers>	حاوية عناصر تكوين المحول البرمجي، يحتوي على صفر أو أكثر من عناصر <compiler>.

ملاحظات

كل عنصر <compiler> يعين سمات تكوين المحول البرمجي لموفر لغة معين. يمتد الموفر الفئة System.CodeDom.Compiler.CodeDomProvider للغة معينة; يعرف العنصر <compiler> إعدادات "منشئ التعليمات البرمجية" و "المترجم" موفر اللغة.

يعرّف .NET Framework الإعدادات الأولية لبرنامج التحويل البرمجي في ملف تكوين الجهاز (Machine.config). يمكن لمطوري و بائعي برنامج التحويل البرمجي إضافة إعدادات تكوين لتطبيق CodeDomProvider جديد. استخدم الأسلوب CodeDomProvider.GetAllCompilerInfo لتعداد إعدادات تكوين المحول البرمجي و موفر اللغة برمجياً على جهاز الكومبيوتر.

عناصر المحوّل البرمجي في التطبيق و ملف تكوين الويب يمكنها تكملة او منع الإعدادات في ملف تكوين الجهاز. إذا تم تكوين تطبيق موفر واحد أو أكثر لنفس اسم اللغة أو نفس ملحق , آخر تكوين مطابق يمنع أية موفّرات تم تكوينها سابقاً لإسم أو ملف اللغة.

ملف التكوين

يمكن استخدام هذا العنصر في ملف تكوين التطبيق أو ملف تكوين الجهاز . (Machine.config).

مثال

المثال التالي يوضّح عنصر تكوين محوّل برمجي نموذجي.

<configuration>
  <system.codedom>
    <compilers>
      <!-- zero or more compiler elements -->
      <compiler
        language="c#;cs;csharp"
        extension=".cs"
        type="Microsoft.CSharp.CSharpCodeProvider, System, 
          Version=2.0.3600.0, Culture=neutral, 
          PublicKeyToken=b77a5c561934e089"
        compilerOptions="/optimize"
        warningLevel="1" />
    </compilers>
  </system.codedom>
</configuration>

راجع أيضًا:

المرجع

CompilerInfo

CodeDomProvider

عنصر <compilers>

المحول البرمجي عنصر compilers لتصنيف (مخطط إعدادات ASP.NET)

المبادئ

تعيين أسماء أنواع المؤهلة بالكامل

موارد أخرى

مخطط ملف التكوين لـ NET Framework. .