C#-compileropties

In deze sectie worden de opties beschreven die door de C#-compiler worden geïnterpreteerd. Opties worden gegroepeerd in afzonderlijke artikelen op basis van wat ze beheren, bijvoorbeeld taalfuncties, codegeneratie 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 uw *.csproj-bestand

  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 eigenschappenpagina's van Visual Studio gebruiken

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

.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 maken gebruik van 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 argumenten weergegeven volgens 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-behind in het web.config-bestand . Zie <compilerelement> voor meer informatie.

Als u de opdrachtprompt voor Ontwikkelaars voor Visual Studio 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 Windows-map . 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 Instructies voor meer informatie over dergelijke installaties : bepalen welke versies van .NET Framework zijn geïnstalleerd.