<compiler> , element

  • Artykuł

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>

Zobacz też