Návrhář projektu .NET (C#)

Pomocí Návrháře projektů určete nastavení a vlastnosti projektu pro .NET Core a .NET 5 nebo novější. V případě projektů .NET Framework a Visual Basic naleznete v tématu Co je Návrhář projektu .NET?.

Pokud chcete získat přístup k Návrháři projektu, zvolte uzel projektu (ne uzel Řešení) v Průzkumník řešení. Potom na řádku nabídek zvolte Vlastnosti projektu>. Zobrazí se Návrhář projektu.

Poznámka:

V počítači se můžou zobrazovat různé názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio v tomto článku. Možná používáte jinou edici sady Visual Studio nebo jiné nastavení prostředí. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Aplikace, obecná nastavení

Následující možnosti umožňují konfigurovat obecná nastavení pro aplikaci.

Typ výstupu

Určuje typ aplikace, která se má sestavit. Hodnoty se liší v závislosti na typu projektu. Například pro projekt konzolové aplikace můžete jako typ výstupu zadat aplikaci systému Windows, konzolovou aplikaci nebo knihovnu tříd.

Další informace o vlastnosti Typ výstupu naleznete v tématu /target (možnosti kompilátoru jazyka C#).

Informace o přístupu k této vlastnosti prostřednictvím kódu programu naleznete v tématu OutputType.

Cílová architektura

Určuje verzi rozhraní .NET, na kterou aplikace cílí. Tato možnost může mít různé hodnoty v závislosti na tom, které verze rozhraní .NET jsou v počítači nainstalované.

Pro projekt, který cílí na .NET Core nebo .NET 5 nebo novější, se dostupné verze můžou zobrazit takto:

Poznámka:

U aplikací ClickOnce jsou požadované balíčky uvedené v dialogovém okně Požadavky nastaveny automaticky při prvním otevření dialogového okna. Pokud následně změníte cílovou architekturu projektu, musíte ručně vybrat požadavky tak, aby odpovídaly nové cílové rozhraní.

Další informace naleznete v tématu Přehled cílení architektury.

Cílový operační systém

Určuje operační systém, na který bude projekt cílit. V kombinaci s cílovou architekturou se vygeneruje TF specifické pro .NET 5 nebo novější.

Spouštěcí objekt

Definuje vstupní bod, který se má volat při načítání aplikace. Obecně se nastaví buď na hlavní formulář v aplikaci, nebo na Main postup, který by se měl spustit při spuštění aplikace. Vzhledem k tomu, že knihovny tříd nemají vstupní bod, jejich jedinou možností pro tuto vlastnost je (Není nastavena).

Ve výchozím nastavení je tato možnost v projektu aplikace WPF nastavená na hodnotu (Nenastavuje se). Druhou možností je [název_projektu].App. V projektu WPF musíte nastavit spouštěcí identifikátor URI pro načtení prostředku uživatelského rozhraní při spuštění aplikace. Uděláte to tak, že otevřete soubor Application.xaml v projektu a nastavíte StartupUri vlastnost na soubor .xaml v projektu, například Window1.xaml. Seznam přijatelných kořenových prvků naleznete v tématu StartupUri. Musíte také definovat metodu public static void Main() ve třídě v projektu. Tato třída se zobrazí v seznamu spouštěcích objektů jako ProjectName.ClassName. Pak můžete vybrat třídu jako spouštěcí objekt.

Další informace najdete v tématu /main (možnosti kompilátoru jazyka C#). Pokud chcete získat přístup k této vlastnosti prostřednictvím kódu programu, přečtěte si téma StartupObject.

Název sestavení

Určuje název výstupního souboru, který bude obsahovat manifest sestavení. Změna této vlastnosti také změní vlastnost Název výstupu.

Tuto změnu můžete provést také z příkazového řádku pomocí příkazu /out (možnosti kompilátoru jazyka C#).

Pokud chcete získat přístup k této vlastnosti prostřednictvím kódu programu, přečtěte si téma AssemblyName.

Výchozí obor názvů

Určuje základní obor názvů pro soubory přidané do projektu.

Další informace o vytváření oborů názvů v kódu najdete v oboru názvů .

Pokud chcete získat přístup k této vlastnosti prostřednictvím kódu programu, přečtěte si téma RootNamespace.

Nastavení aplikace, prostředků Win32

Ikona

Nastaví soubor .ico, který chcete použít jako ikonu programu. Kliknutím na Tlačítko Procházet vyhledejte existující grafiku nebo zadejte název požadovaného souboru. Další informace najdete v tématu /win32icon (možnosti kompilátoru jazyka C#).

Pokud chcete získat přístup k této vlastnosti prostřednictvím kódu programu, přečtěte si téma ApplicationIcon.

Informace o vytvoření ikony naleznete v tématu Editor obrázků pro ikony.

Materiály

Možnost Prostředky vám pomůže nakonfigurovat nastavení prostředků pro vaši aplikaci. Ve výchozím nastavení jsou povoleny možnosti Ikona a Manifest . To vám umožní vybrat vlastní ikonu nebo vybrat různé možnosti generování manifestu. Toto přepínač nechte vybrané, pokud pro projekt nezadáte soubor zdroje.

Pokud vyberete Soubor zdroje, nakonfigurujte pro projekt soubor zdroje. Zadejte název cesty nebo pomocí tlačítka Procházet přidejte do projektu soubor zdroje Win32. Další informace najdete v tématu Vytváření souborů prostředků pro aplikace .NET.

Manifestu

Vybere možnost generování manifestu, když aplikace běží ve Windows v části Řízení uživatelských účtů (UAC). Tato možnost může mít následující hodnoty:

• Vložení manifestu s výchozím nastavením Podporuje typický způsob, jakým Visual Studio pracuje ve Windows, což je vložení informací o zabezpečení do spustitelného souboru aplikace, který určuje, že requestedExecutionLevel .AsInvoker Toto je výchozí možnost.

• Vytvoření aplikace bez manifestu Tato metoda se označuje jako virtualizace. Tuto možnost použijte pro kompatibilitu s dřívějšími aplikacemi.

• Použijte vlastní manifest. Umožňuje zadat cestu nebo přejít k vlastnímu manifestu projektu.

Globální nastavení používání

Implicitní globální použití

Povolí nebo zakáže globální použití, což umožňuje používat typy definované v oboru názvů bez zadání plně kvalifikovaného oboru názvů.

Správa implicitních globálních použití

Ručně přidejte a odstraňte globální použití pro použití v projektech.

Sestavení, obecné nastavení

Symboly podmíněné kompilace

Určuje symboly, pro které se má provést podmíněná kompilace. Oddělte symboly středníkem (";"). Další informace najdete v tématu /define (možnosti kompilátoru jazyka C#).

Ladění vlastních symbolů

Určuje symboly pro podmíněnou kompilaci pro sestavení ladění. Výchozí symboly ladění se zobrazí v řetězci oddělené středníky.

Uvolnit vlastní symboly

Určuje symboly pro podmíněnou kompilaci pro sestavení vydané verze. Výchozí symboly vydané verze se zobrazí v řetězci oddělené středníky.

Cíl platformy

Určuje procesor, který má být cílem výstupního souboru. Zvolte x86 pro libovolný 32bitový procesor kompatibilní s Intel, zvolte x64 pro libovolný 64bitový procesor intel kompatibilní, zvolte ARM pro procesory ARM nebo zvolte Libovolný procesor , který určuje, že jakýkoli procesor je přijatelný. Jakýkoli procesor je výchozí hodnota pro projekty, protože umožňuje aplikaci spouštět na nejširším rozsahu hardwaru.

Další informace najdete v tématu /platform (možnosti kompilátoru jazyka C#).

Nullable

Určuje kontext jazyka C# s možnou hodnotou null pro celý projekt. Tato možnost uživatelského rozhraní byla zavedena v sadě Visual Studio 16.5 a je povolená pouze pro projekty, které používají C# 8.0 nebo novější.

Další informace naleznete v tématu Kontexty s možnou hodnotou Null.

Generování informací o sestavení

Určuje, zda jsou vlastnosti projektu související s balíčkem transformovány na atributy sestavení. Další informace naleznete v GenerateAssemblyInfo vlastnost.

Nebezpečný kód

Umožňuje kód, který ke kompilaci používá nebezpečné klíčové slovo. Další informace najdete v tématu /nezabezpečené (možnosti kompilátoru jazyka C#).

Optimalizace kódu

Povolte nebo zakažte optimalizace prováděné kompilátorem, aby byl výstupní soubor menší, rychlejší a efektivnější. Další informace najdete v tématu /optimize (možnosti kompilátoru jazyka C#).

Symboly ladění

Určuje typ informací o ladění generovaných kompilátorem. Informace o konfiguraci výkonu ladění aplikace naleznete v tématu DebugType compiler option. Toto nastavení má následující možnosti:

• žádné

  Určuje, že nebudou generovány žádné informace o ladění.

• Plné

  Umožňuje připojení ladicího programu ke spuštěné aplikaci.

• pdbonly

  Umožňuje ladění zdrojového kódu při spuštění programu v ladicím programu, ale zobrazí se pouze assembler při připojení spuštěného programu k ladicím programu.

• Přenosné

  Vytvoří . PDB soubor, neformaně specifický, přenosný symbol soubor, který poskytuje další nástroje, zejména ladicí programy, informace o tom, co je v hlavním spustitelném souboru a jak byl vytvořen. Další informace najdete v tématu Portable PDB .

• Vložené

  Vloží do sestavení přenosné informace o symbolech. Žádné vnější . Vytvoří se soubor PDB.

Další informace najdete v tématu /debug (možnosti kompilátoru jazyka C#).>

Nastavení sestavení, chyb a upozornění

Následující nastavení slouží ke konfiguraci možností chyby a upozornění pro proces sestavení.

Úroveň upozornění

Určuje úroveň, která se má zobrazit pro upozornění kompilátoru. Další informace najdete v tématu /warn (možnosti kompilátoru jazyka C#).

Potlačení konkrétních upozornění

Blokuje schopnost kompilátoru generovat jedno nebo více konkrétních upozornění. Více čísel upozornění oddělte čárkou nebo středníkem. Další informace najdete v tématu /nowarn (možnosti kompilátoru jazyka C#).

Zacházení s upozorněními jako s chybami

Vyberte, jestli se upozornění během procesu sestavení považují za chyby. Další informace najdete v tématu /warnaserror (možnosti kompilátoru jazyka C#).

Zacházení s konkrétními upozorněními jako s chybami

Určete, která upozornění se považují za chyby. Více čísel upozornění oddělte čárkou nebo středníkem.

Tip

Pokud nechcete, aby se upozornění analýzy kódu považovala za chyby, přečtěte si nejčastější dotazy k analýze kódu.

Nastavení sestavení, výstupu

Následující nastavení slouží ke konfiguraci možností výstupu pro proces sestavení.

Základní výstupní cesta

Určuje umístění výstupních souborů pro konfiguraci tohoto projektu. Do tohoto pole zadejte cestu výstupu sestavení nebo zvolte tlačítko Procházet a zadejte cestu. Cesta je relativní; Pokud zadáte absolutní cestu, uloží se jako relativní. Výchozí cesta je bin\Debug nebo bin\Release\.

Ve zjednodušené konfiguraci sestavení systém projektu určuje, jestli se má sestavit ladicí nebo vydaná verze. Příkaz Sestavení z nabídky Ladění (F5) umístí sestavení do umístění ladění bez ohledu na zadaná výstupní cesta . Příkaz Sestavení z nabídky Sestavení ho ale umístí do zadaného umístění. Další informace najdete v tématu Principy konfigurací sestavení.

Referenční sestavení

Určuje, zda se má vygenerovat referenční sestavení obsahující veřejné rozhraní API projektu.

Soubor dokumentace

Určuje název souboru, do kterého se budou zpracovávat komentáře dokumentace. Další informace najdete v tématu /doc (možnosti kompilátoru jazyka C#).a0>

Sestavení, nastavení událostí

Informace o nastavení události sestavení najdete v tématu Určení událostí sestavení (C#).

Sestavení, publikování nastavení

Publikování

Umožňuje spuštění cíle publikování nástroje MSBuild. Další informace naleznete v MSBuild IsPublishable vlastnost.

Publikování oříznuté

Určuje, jestli je během procesu publikování povolené oříznutí. Další informace naleznete v tématu Trim-related properties.

Publikování nativního AOT

Určuje, jestli se má vytvořit aplikace, která je samostatná a která byla předem zkompilována do nativního kódu. Další informace najdete v tématu Nativní nasazení AOT.

Sestavení, nastavení silného pojmenování

Podepsání sestavení

Toto políčko zaškrtněte, chcete-li podepsat sestavení a vytvořit soubor klíče se silným názvem. Další informace o podepisování sestavení pomocí Návrháře projektu naleznete v tématu Postupy: Podepsání sestavení (Visual Studio). Další informace naleznete v tématu Sestavení se silným názvem.

Tato možnost používá k podepsání sestavení nástroj Al.exe poskytovaný sadou Windows Software Development Kit (SDK). Další informace o Al.exe naleznete v tématu Postupy: Podepsání sestavení silným názvem.

Seznam souborů se silným názvem

Umožňuje zadat nový nebo existující soubor klíče se silným názvem, který se používá k podepsání sestavení. Vyberte <Procházet...> a vyberte existující soubor klíče.

Pouze znaménko zpoždění

Toto políčko zaškrtněte, pokud chcete povolit odložení podepisování. Další informace naleznete v tématu Zpoždění podepsání sestavení.

Všimněte si, že zpožděný podepsaný projekt se nespustí a nelze ho ladit. Můžete ale použít Sn.exe (Nástroj silného -Vr názvu) s možností přeskočit ověření během vývoje.

Poznámka:

Když podepíšete sestavení, možná nebudete mít vždy přístup k privátnímu klíči. Organizace může mít například úzce strážený pár klíčů, ke kterému vývojáři nemají přístup každý den. Veřejný klíč může být dostupný, ale přístup k privátnímu klíči je omezený na několik jednotlivců. V takovém případě můžete k poskytnutí veřejného klíče použít opožděné nebo částečné podepisování , odložení přidání privátního klíče do předání sestavení.

Sestavení, upřesňující nastavení

Následující možnosti umožňují nastavit upřesňující nastavení sestavení.

Jazyková verze

Odkazy na /langversion (možnosti kompilátoru jazyka C#), které poskytují informace o tom, jak je zvolena výchozí jazyková verze na základě cílové architektury projektu.

Kontrola aritmetického přetečení

Určuje, jestli celočíselný aritmetický příkaz, který není v oboru zaškrtnutých nebo nezaškrtnutých klíčových slov a výsledkem je hodnota mimo rozsah datového typu, způsobí výjimku za běhu. Další informace najdete v tématu /checked (možnosti kompilátoru jazyka C#).

Deterministický

Určuje, jestli se má vytvořit ekvivalentní výstup bajtu pro bajt ze stejného vstupního zdroje. Další informace naleznete v tématu Možnosti kompilátoru jazyka C#, které řídí generování kódu.

Zasílání zpráv o vnitřních chybách kompilátoru

Určuje, jestli má microsoftu hlásit chyby kompilátoru. Pokud je nastavená na výzvu (výchozí), zobrazí se výzva, pokud dojde k vnitřní chybě kompilátoru a poskytnete možnost odeslání zprávy o chybách elektronicky společnosti Microsoft. Pokud je nastaveno odeslání, automaticky se odešle zpráva o chybě. Pokud je nastavená na frontu, zprávy o chybách se zařadí do fronty. Pokud je nastavená hodnota žádná, zobrazí se chyba pouze v textovém výstupu kompilátoru. Další informace najdete v tématu /errorreport (možnosti kompilátoru jazyka C#).a0>

Zarovnání souboru

Určuje velikost oddílů ve výstupním souboru. Platné hodnoty jsou 512, 1024, 2048, 4096 a 8192. Tyto hodnoty se měří v bajtech. Každý oddíl bude zarovnán na hranici, která je násobkem této hodnoty, což má vliv na velikost výstupního souboru. Další informace najdete v tématu /filealign (možnosti kompilátoru jazyka C#).

Balíček, obecná nastavení

Vlastnosti v této části slouží ke konfiguraci balíčků, obecně odpovídajících vlastnostem v souboru NuGet .nuspec . Další informace naleznete v souboru .nuspec.

Balíček, nastavení licence

Licence balíčku

Určuje, jestli se má do balíčku zahrnout licenční výraz nebo soubor licence. Další informace najdete v elementu licence .

Nastavení balíčku, symbolů

Vytvoření balíčku symbolů

Určuje, jestli se má vytvořit balíček symbolů pro ladění. Další informace naleznete v tématu Vytváření balíčků symbolů (.snupkg).

Analýza kódu, všechna nastavení analyzátoru

Spuštění při sestavení

Určuje, jestli se má při sestavování projektu spustit analýza zdrojového kódu. Další informace naleznete v tématu Zakázání analýzy zdrojového kódu pro .NET.

Spuštění při živé analýze

Určuje, jestli se má při sestavování projektu spustit analýza živého zdrojového kódu. Další informace naleznete v tématu Zakázání analýzy zdrojového kódu pro .NET.

Analýza kódu, nastavení analyzátoru .NET

Vynucování stylu kódu při sestavení

Určuje, jestli se při sestavování projektu hlásí porušení stylu kódu .NET. Další informace naleznete v tématu Vynucení stylů kódu při sestavení.

Povolení analyzátorů .NET

Povolí nebo zakáže analyzátory kompilátoru .NET (Roslyn). Další informace naleznete v tématu Povolení nebo instalace analyzátorů .NET první strany.

Úroveň analýzy

Určuje sadu analyzátorů, které se mají v projektu spouštět. Další informace najdete v části Nejnovější aktualizace v článku s přehledem analýzy kódu.

Ladění, obecné nastavení

Výběrem odkazu otevřete uživatelské rozhraní profilů spuštění ladění. Toto uživatelské rozhraní umožňuje přidat a nakonfigurovat různé profily, které se mají použít při ladění. Každý název profilu se zobrazí jako spouštěcí možnost v seznamu Spustit ladění .

U ASP.NET základních projektů odpovídají nastavení v uživatelském rozhraní profilů spuštění nastavení v souboru spuštění projektu Nastavení.json. Podrobné informace o tom, jak se tento soubor používá ve vývoji ASP.NET, najdete v tématu Vývoj a spuštění Nastavení.json.

Zdroje, obecná nastavení

Výběrem odkazu otevřete soubor prostředků sestavení RESX. Další informace naleznete na stránce Nastavení, Návrhář projektu.

Viz také

Přepracované uživatelské rozhraní vlastností projektu