<> fordítóelem

Cikk
04/06/2024

Megadja egy nyelvszolgáltató fordítókonfigurációs attribútumait.

<Konfigurációs>
  <system.codedom>
    <Fordítóprogramok>
      <Fordító>

Syntax

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

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attribútumok

Attribútum	Leírás
`compilerOptions`	Nem kötelező attribútum. További fordítóspecifikus argumentumokat ad meg a fordításhoz. Az attribútum értékei `compilerOptions` általában a fordító fordítóbeállítási témakörében jelennek meg.
`extension`	Kötelező attribútum. Pontosvesszővel tagolt listát biztosít a nyelvszolgáltató forrásfájljai által használt fájlnévkiterjesztésekről. Például: ".cs".
`language`	Kötelező attribútum. Pontosvesszővel tagolt listát biztosít a nyelvszolgáltató által támogatott nyelvnevekről. Például: "c#; Cs; csharp".
`type`	Kötelező attribútum. Megadja a nyelvi szolgáltató típusnevét, beleértve a szolgáltató implementációját tartalmazó szerelvény nevét is. A típusnévnek meg kell felelnie a Teljes típusnevek megadása című témakörben meghatározott követelményeknek.
`warningLevel`	Nem kötelező attribútum. Megadja az alapértelmezett fordítói figyelmeztetési szintet; meghatározza, hogy a nyelvi szolgáltató milyen szinten kezeli a fordítási figyelmeztetéseket hibákként.

Gyermekelemek

Elem	Leírás
<providerOption> elem	A fordító verzióattribútumait adja meg egy nyelvi szolgáltatóhoz.

Szülőelemek

Elem	Leírás
<konfigurációs> elem	A közös nyelvi futtatókörnyezet és .NET-keretrendszer alkalmazások által használt összes konfigurációs fájl gyökéreleme.
<system.codedom> elem	Az elérhető nyelvi szolgáltatók fordítókonfigurációs beállításait adja meg.
<fordítók> eleme	Tároló fordítókonfigurációs elemekhez; nulla vagy több `<compiler>` elemet tartalmaz.

Megjegyzések

Minden <compiler> elem egy adott nyelvi szolgáltató fordítókonfigurációs attribútumait adja meg. A szolgáltató kiterjeszti az System.CodeDom.Compiler.CodeDomProvider osztályt egy adott nyelvre; az <compiler> elem meghatározza a nyelvi szolgáltató fordító- és kódgenerátor-beállításait.

A .NET-keretrendszer határozza meg a kezdeti fordítóbeállításokat a gép konfigurációs fájljában (Machine.config). A fejlesztők és a fordítógyártók konfigurációs beállításokat adhatnak hozzá egy új CodeDomProvider implementációhoz. CodeDomProvider.GetAllCompilerInfo A módszerrel programozott módon számba lehet adni a nyelvi szolgáltató és a fordító konfigurációs beállításait a számítógépen.

Az alkalmazás- vagy webkonfigurációs fájlban lévő fordítóelemek kiegészíthetik vagy felülbírálhatják a gép konfigurációs fájljának beállításait. Ha egynél több szolgáltatói implementáció van konfigurálva ugyanahhoz a nyelvnévhez vagy fájlkiterjesztéshez, az utolsó egyező konfiguráció felülírja az adott nyelv vagy fájlkiterjesztés korábbi konfigurált szolgáltatóit.

Konfigurációs fájl

Ez az elem használható a gép konfigurációs fájljában és az alkalmazáskonfigurációs fájlban.

Példa

Az alábbi példa egy tipikus fordítókonfigurációs elemet mutat be:

<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>

Megosztás a következőn keresztül: