<compiler> , element

Artykuł
04/06/2024

Określa atrybuty konfiguracji kompilatora dla dostawcy języka.

<konfiguracji>
  <System.codedom>
    <Kompilatory>
      <Kompilator>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	opis
`compilerOptions`	Atrybut opcjonalny. Określa dodatkowe argumenty specyficzne dla kompilatora dla kompilacji. Wartości atrybutu `compilerOptions` są zwykle wyświetlane w temacie opcji kompilatora dla kompilatora.
`extension`	Atrybut wymagany. Udostępnia rozdzieloną średnikami listę rozszerzeń nazw plików używanych przez pliki źródłowe dostawcy języka. Na przykład ".cs".
`language`	Atrybut wymagany. Udostępnia rozdzieloną średnikami listę nazw języków obsługiwanych przez dostawcę języka. Na przykład "c#; Cs; csharp".
`type`	Atrybut wymagany. Określa nazwę typu dostawcy języka, w tym nazwę zestawu zawierającego implementację dostawcy. Nazwa typu musi spełniać wymagania zdefiniowane w temacie Określanie w pełni kwalifikowanych nazw typów.
`warningLevel`	Atrybut opcjonalny. Określa domyślny poziom ostrzeżenia kompilatora; określa poziom, na którym dostawca języka traktuje ostrzeżenia kompilacji jako błędy.

Elementy podrzędne

Element	opis
<providerOption> , element	Określa atrybuty wersji kompilatora dla dostawcy języka.

Elementy nadrzędne

Element	opis
<configuration> , element	Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
<system.codedom> , element	Określa ustawienia konfiguracji kompilatora dla dostępnych dostawców języka.
<compilers> , element	Kontener dla elementów konfiguracji kompilatora; zawiera zero lub więcej `<compiler>` elementów.

Uwagi

Każdy <compiler> element określa atrybuty konfiguracji kompilatora dla określonego dostawcy języka. Dostawca rozszerza klasę System.CodeDom.Compiler.CodeDomProvider dla określonego języka. <compiler> Element definiuje ustawienia kompilatora i generatora kodu dla dostawcy języka.

Program .NET Framework definiuje początkowe ustawienia kompilatora w pliku konfiguracji maszyny (Machine.config). Deweloperzy i dostawcy kompilatora mogą dodawać ustawienia konfiguracji dla nowej CodeDomProvider implementacji. CodeDomProvider.GetAllCompilerInfo Użyj metody , aby programowo wyliczyć dostawcę języka i ustawienia konfiguracji kompilatora na komputerze.

Elementy kompilatora w pliku konfiguracji aplikacji lub sieci Web mogą uzupełniać lub zastępować ustawienia w pliku konfiguracji maszyny. Jeśli dla tej samej nazwy języka lub tego samego rozszerzenia pliku skonfigurowano więcej niż jedną implementację dostawcy, ostatnia zgodna konfiguracja zastępuje wszystkich poprzednich skonfigurowanych dostawców dla tej nazwy języka lub rozszerzenia pliku.

Plik konfiguracji

Tego elementu można użyć w pliku konfiguracji maszyny i pliku konfiguracji aplikacji.

Przykład

Poniższy przykład ilustruje typowy element konfiguracji kompilatora:

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

Udostępnij za pośrednictwem