C#-compileropties

In deze sectie worden de opties beschreven die worden geïnterpreteerd door de C#-compiler. Opties worden gegroepeerd in afzonderlijke artikelen op basis van wat ze beheren, bijvoorbeeld taalfuncties, het genereren van code en uitvoer. Gebruik de inhoudsopgave om ertussen te navigeren.

Opties instellen

Er zijn twee verschillende manieren om compileropties in te stellen in .NET-projecten:

• In het bestand *.csproj

  U kunt MSBuild-eigenschappen toevoegen voor elke compileroptie in uw *.csproj-bestand in XML-indeling. De eigenschapsnaam is hetzelfde als de compileroptie. Met de waarde van de eigenschap wordt de waarde van de compileroptie ingesteld. Met het volgende projectbestandsfragment wordt bijvoorbeeld de LangVersion eigenschap ingesteld.

  <PropertyGroup>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

  Zie het artikel MSBuild-eigenschappen voor .NET SDK Projects voor meer informatie over het instellen van opties in projectbestanden.

• De Visual Studio eigenschappenpagina's gebruiken

  Visual Studio biedt eigenschappenpagina's voor het bewerken van build-eigenschappen. Zie Project- en oplossingseigenschappen beheren - Windows project- en oplossingseigenschappen beheren - Mac voor meer informatie.

.NET Framework projecten

Belangrijk

Deze sectie is alleen van toepassing op .NET Framework projecten.

Naast de hierboven beschreven mechanismen kunt u compileropties instellen met behulp van twee extra methoden voor .NET Framework projecten:

• Opdrachtregelargumenten voor .NET Framework projecten: .NET Framework projecten gebruiken csc.exe in plaats van dotnet build projecten te bouwen. U kunt opdrachtregelargumenten opgeven voor csc.exe voor .NET Framework projecten.
• Gecompileerde ASP.NET pagina's: .NET Framework projecten gebruiken een sectie van het web.config-bestand voor het compileren van pagina's. Voor het nieuwe buildsysteem en ASP.NET Core projecten worden opties uit het projectbestand genomen.

Het woord voor sommige compileropties is gewijzigd van csc.exe en .NET Framework projecten in het nieuwe MSBuild-systeem. De nieuwe syntaxis wordt in deze sectie gebruikt. Beide versies worden boven aan elke pagina weergegeven. Voor csc.exeworden alle argumenten weergegeven na de optie en een dubbele punt. De optie is bijvoorbeeld -doc :

-doc:DocFile.xml

U kunt de C#-compiler aanroepen door de naam van het uitvoerbare bestand (csc.exe) te typen bij een opdrachtprompt.

Voor .NET Framework projecten kunt u ook csc.exe uitvoeren vanaf de opdrachtregel. Elke compileroptie is beschikbaar in twee vormen: -option en /option. In .NET Framework webprojecten geeft u opties op voor het compileren van code-achter in het web.config-bestand. Zie compilerelement> voor meer informatie<.

Als u de opdrachtprompt voor ontwikkelaars voor Visual Studio venster gebruikt, worden alle benodigde omgevingsvariabelen voor u ingesteld. Zie De opdrachtprompt voor ontwikkelaars voor Visual Studio voor meer informatie over het openen van dit hulpprogramma.

Het uitvoerbare bestandcsc.exe bevindt zich meestal in de map Microsoft.NET\Framework\<Version> onder de map Windows. De locatie kan variëren, afhankelijk van de exacte configuratie van een bepaalde computer. Als meer dan één versie van .NET Framework op uw computer is geïnstalleerd, vindt u meerdere versies van dit bestand. Zie Procedure voor meer informatie over dergelijke installaties: bepalen welke versies van de .NET Framework zijn geïnstalleerd.