Sdílet prostřednictvím


Návrhář projektu .NET

Pomocí Návrháře projektu určete nastavení a vlastnosti projektu pro .NET Core a .NET 5 nebo novější. Informace o rozhraní .NET Framework najdete v tématu Co je Návrhář projektu .NET?.

Pokud chcete získat přístup k Návrháři projektu, zvolte uzel projektu (nikoli uzel řešení ) v průzkumníku řešení . Potom na řádku nabídek zvolte Project>Vlastnosti. Zobrazí se návrháře 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 zadat aplikace systému Windows, konzolové aplikacenebo knihovnu tříd jako typ výstupu.

Další informace o vlastnosti typu 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é architektury

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:

snímek obrazovky s verzemi cílové architektury pro projekt .NET Core v sadě Visual Studio 2022

Poznámka

U aplikací ClickOnce jsou požadované balíčky uvedené v dialogovém okně Požadavky automaticky nastaveny 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 Framework cílení přehled.

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 .NET 5 nebo více operačního systému TF.

spouštěcího objektu

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 proceduru, která by se měla 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í nastaveno).

Ve výchozím nastavení je v projektu aplikace WPF tato možnost nastavena na (nenastavované). 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. Chcete-li to provést, otevřete soubor Application.xaml v projektu a nastavte vlastnost StartupUri na soubor .xaml v projektu, například Window1.xaml. Seznam přijatelných kořenových prvků najdete v tématu StartupUri. Musíte také definovat public static void Main() metodu ve třídě v projektu. Tato třída se zobrazí v seznamu Spouštěcí objekt jako ProjectName.ClassName. Pak můžete vybrat třídu jako spouštěcí objekt.

Další informace najdete v /main (možnosti kompilátoru jazyka C#). Pokud chcete k této vlastnosti přistupovat prostřednictvím kódu programu, přečtěte si 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í/out (možnosti kompilátoru jazyka C#).

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

výchozí oboru 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 k této vlastnosti přistupovat prostřednictvím kódu programu, přečtěte si RootNamespace.

Nastavení aplikace, prostředků Win32

ikony

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

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

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

prostředků

Možnost Prostředky vám pomůže nakonfigurovat nastavení prostředků pro vaši aplikaci. Ve výchozím nastavení jsou povolené možnosti Ikona a manifestu. 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 prostředků, nakonfigurujte soubor zdroje pro projekt. Zadejte název cesty nebo pomocí tlačítka Procházet přidejte do projektu soubor zdroje Win32. Další informace najdete v tématu Vytvoř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žit manifest s výchozím nastavením. Podporuje typický způsob, jakým Sada Visual Studio pracuje ve Windows, což je vložení informací o zabezpečení do spustitelného souboru aplikace, které určují, že requestedExecutionLevel být AsInvoker. Toto je výchozí možnost.

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

  • Použít vlastnímanifestu . 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ů.

spravovat implicitní globální 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íle platformy

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

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

s možnou hodnotou null

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 najdete v tématu kontexty s možnou hodnotou Null.

Generování informací o sestavení

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

nebezpečný kód

Umožňuje kód, který ke kompilaci nebezpečného klíčového slova. Další informace najdete v tématu/unsafe (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/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 možnost kompilátoru. Toto nastavení má následující možnosti:

  • žádné

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

  • úplných

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

  • 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.

  • embedded

    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čit konkrétní 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/nowarn (možnosti kompilátoru jazyka C#).

považovat upozornění za chyby

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

považovat konkrétní upozornění za chyby

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

Spropitné

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í.

výchozí 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 výstupní cestu, zadáte. Příkaz Sestavení z nabídky Sestavení 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.

souboru dokumentace

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

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 nástroji MSBuild IsPublishable vlastnost.

publikování oříznutých

Určuje, jestli je během procesu publikování povolené oříznutí. Další informace najdete v tématu vlastnosti související s oříznutím.

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 naleznete v tématu nativní nasazení AOT.

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

Podepište 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ář projektunaleznete 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.exenaleznete v tématu Postupy: Podepsání sestavení silným názvem.

seznam souboru klíče silného názvu

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...> vyberte existující soubor klíče.

znaménko zpoždění pouze

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 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 použít zpožděné nebo částečné podepisování k poskytnutí veřejného klíče a odložení přidání soukromého klíče, dokud se sestavení nepředá.

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

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

verze jazyka

Odkazy na /langversion (možnosti kompilátoru jazyka C#), která poskytuje 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é nebo nezaškrtnuté 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/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.

interního hlášení chyb kompilátoru

Určuje, jestli má microsoftu hlásit chyby kompilátoru. Pokud je tato možnost nastavená na výzvy (výchozí), zobrazí se výzva, pokud dojde k vnitřní chybě kompilátoru a poskytnete možnost elektronicky odeslat zprávu o chybě společnosti Microsoft. Pokud je nastavená hodnota odeslat, automaticky se odešle zpráva o chybě. Pokud je nastavená fronta, 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#).

zarovnání souboru

Určuje velikost oddílů ve výstupním souboru. Platné hodnoty jsou 512, 1024, 2048, 4096a 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/filealign (možnosti kompilátoru jazyka C#).

Balíček, obecná nastavení

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

Balíček, nastavení licence

licenční balíčku

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

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

Spustit v sestavení

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

Spustit 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 najdete v tématu Zakázání analýzy zdrojového kódu pro .NET.

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

Vynutit styl kódu v sestavení

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

Povolení analyzátorů .NET

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

na úrovni 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 úvodní možnost v seznamu Spustit ladění.

Pro projekty ASP.NET Core odpovídají nastavení v uživatelském rozhraní profilů spuštění nastavení v souboru launchSettings.json projektu. Podrobné informace o tom, jak se tento soubor používá ve vývoji ASP.NET, naleznete v tématu Vývoj a launchSettings.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ých uživatelských rozhraní vlastností projektu