C#-fordító beállításai

Ez a szakasz a C#-fordító által értelmezett beállításokat ismerteti. A beállítások külön cikkekbe vannak csoportosítva, például a nyelvi funkciók, a kódgenerálás és a kimenet alapján. A tartalomjegyzék használatával navigálhat közöttük.

Beállítások megadása

A .NET-projektekben kétféleképpen állíthat be fordítóbeállításokat:

• A *.csproj fájlban

  A *.csproj fájl bármely fordítóbeállításához hozzáadhat MSBuild tulajdonságokat XML formátumban. A tulajdonság neve megegyezik a fordító beállításával. A tulajdonság értéke beállítja a fordító beállítás értékét. A következő projektfájl-kódrészlet például beállítja a tulajdonságot LangVersion .

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

  A projektfájlok beállításainak beállításáról további információt a .NET SDK-projektek MSBuild tulajdonságai című cikkben talál.

• A Visual Studio tulajdonságlapjainak használata

  A Visual Studio tulajdonságlapokat biztosít a buildtulajdonságok szerkesztéséhez. További információ ezekről: Projekt- és megoldástulajdonságok kezelése – Windows vagy Projekt- és megoldástulajdonságok kezelése – Mac.

.NET-keretrendszer-projektek

Fontos

Ez a szakasz csak .NET-keretrendszerprojektekre vonatkozik.

A fent ismertetett mechanizmusokon kívül a .NET-keretrendszerprojektekhez két további módszerrel is beállíthatja a fordítási beállításokat:

• Parancssori argumentumok .NET-keretrendszerprojektekhez: A .NET-keretrendszer-projektek a projektek létrehozása helyett dotnet buildcsc.exehasználnak. A .NET-keretrendszer-projektekhez megadhat parancssori argumentumokatcsc.exe.
• Lefordított ASP.NET lapok: A .NET-keretrendszer-projektek a web.config fájl egy szakaszát használják a lapok összeállításához. Az új buildrendszer és ASP.NET Core-projektek esetében a beállítások a projektfájlból származnak.

Egyes fordítóbeállítások neve csc.exe és .NET-keretrendszer-projektekről az új MSBuild rendszerre módosult. Az új szintaxist ebben a szakaszban használjuk. Mindkét verzió az egyes lapok tetején található. Acsc.exeesetén az argumentumok a beállítás és a kettőspont után jelennek meg. A beállítás például a -doc következő:

-doc:DocFile.xml

A C#-fordító meghívásához írja be a végrehajtható fájl nevét (csc.exe) egy parancssorba.

.NET-keretrendszer-projektek esetén a parancssorból is futtathat csc.exe . Minden fordítóbeállítás két formában érhető el: -option és /option. A .NET-keretrendszer webes projektjeiben megadhatja a kód mögötti kód összeállításának lehetőségeit a web.config fájlban. További információ: <compiler> Elem.

Ha a Visual Studio fejlesztői parancssorát használja, az összes szükséges környezeti változó be van állítva. Az eszköz eléréséről további információt a Visual Studio fejlesztői parancssorában talál.

A csc.exe végrehajtható fájl általában a < könyvtár alatti Microsoft.NET\Framework\>Version mappában található. A hely az adott számítógép pontos konfigurációjától függően változhat. Ha a .NET-keretrendszer több verziója is telepítve van a számítógépre, a fájl több verzióját is megtalálja. Az ilyen telepítésekkel kapcsolatos további információkért tekintse meg a .NET-keretrendszer telepített verzióinak meghatározását ismertető témakört.