Možnosti kompilátoru jazyka C#

Tato část popisuje možnosti interpretované kompilátorem jazyka C#. Možnosti jsou seskupené do samostatných článků na základě toho, co řídí, například funkce jazyka, generování kódu a výstup. Obsah můžete použít k procházení mezi nimi.

Jak nastavit možnosti

Existují dva různé způsoby nastavení možností kompilátoru v projektech .NET:

• V souboru *.csproj

  Vlastnosti MSBuild můžete přidat pro libovolnou možnost kompilátoru v souboru *.csproj ve formátu XML. Název vlastnosti je stejný jako možnost kompilátoru. Hodnota vlastnosti nastaví hodnotu možnosti kompilátoru. Například následující fragment kódu souboru projektu nastaví LangVersion vlastnost.

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

  Další informace o nastavení možností v souborech projektu naleznete v článku MSBuild vlastnosti pro projekty sady .NET SDK.

• Použití stránek vlastností sady Visual Studio

  Visual Studio poskytuje stránky vlastností pro úpravu vlastností sestavení. Další informace o nich najdete v tématu Správa vlastností projektu a řešení – Windows nebo Správa vlastností projektu a řešení – Mac.

Projekty rozhraní .NET Framework

Důležité

Tato část se vztahuje pouze na projekty rozhraní .NET Framework.

Kromě výše popsaných mechanismů můžete nastavit možnosti kompilátoru pomocí dvou dalších metod pro projekty rozhraní .NET Framework:

• Argumenty příkazového řádku pro projekty rozhraní .NET Framework: Projekty rozhraní .NET Framework místo sestavení projektů používají csc.exedotnet build . Můžete zadat argumenty příkazového řádku pro csc.exe pro projekty rozhraní .NET Framework.
• Kompilované ASP.NET stránky: Projekty rozhraní .NET Framework používají část souboru web.config pro kompilaci stránek. Pro nový systém sestavení a ASP.NET základní projekty jsou možnosti převzaty ze souboru projektu.

Slovo pro některé možnosti kompilátoru se změnilo z projektů csc.exe a .NET Framework na nový systém MSBuild. Nová syntaxe se používá v této části. Obě verze jsou uvedeny v horní části každé stránky. Pro csc.exejsou všechny argumenty uvedené za možností a dvojtečku. Tato možnost by například -doc byla:

-doc:DocFile.xml

Kompilátor jazyka C# můžete vyvolat zadáním názvu jeho spustitelného souboru (csc.exe) do příkazového řádku.

Pro projekty rozhraní .NET Framework můžete také spustit csc.exe z příkazového řádku. Každá možnost kompilátoru je k dispozici ve dvou formách: -option a /option. Ve webových projektech rozhraní .NET Framework zadáte v souboruweb.config možnosti kompilace kódu. Další informace naleznete v tématu <compiler> Element.

Pokud použijete okno Vývojářský příkazový řádek pro Visual Studio , nastaví se pro vás všechny potřebné proměnné prostředí. Informace o tom, jak získat přístup k tomuto nástroji, naleznete v tématu Developer Command Prompt for Visual Studio.

Spustitelný soubor csc.exe se obvykle nachází ve složce Microsoft.NET\Framework\<Version> v adresáři Systému Windows . Jeho umístění se může lišit v závislosti na přesné konfiguraci konkrétního počítače. Pokud je v počítači nainstalováno více verzí rozhraní .NET Framework, najdete více verzí tohoto souboru. Další informace o takových instalacích naleznete v tématu Postupy: určení, které verze rozhraní .NET Framework jsou nainstalovány.