Výchozí šablony pro dotnet new

Při instalaci sady .NET SDK získáte více než tucet předdefinovaných šablon pro vytváření projektů a souborů, včetně konzolových aplikací, knihoven tříd, projektů testů jednotek, ASP.NET základních aplikací (včetně projektů Angular a React ) a konfiguračních souborů. Pokud chcete zobrazit seznam předdefinovaných šablon, spusťte dotnet new list příkaz:

dotnet new list

Možnosti šablony

Šablony, které jsou dodávány se sadou .NET SDK, mají možnosti specifické pro šablony. Pokud chcete zobrazit další možnosti dostupné pro šablonu, použijte --help možnost s argumentem názvu šablony, například: dotnet new console --help. Oddíly specifické pro šablonu v tomto článku také popisují možnosti.

Pokud šablona podporuje více programovacích jazyků, --help možnost zobrazí nápovědu pro šablonu ve výchozím jazyce. Když ji zkombinujete s --language možností, zobrazí se nápověda pro jiné jazyky: dotnet new console --help --language F#.

Předinstalované šablony

Následující tabulka ukazuje šablony, které jsou předinstalované pomocí sady .NET SDK. Výchozí jazyk šablony se zobrazuje uvnitř závorek. Pokud chcete zobrazit jakékoli možnosti specifické pro šablonu, vyberte odkaz na krátký název.

Šablony Krátký název Jazyk Značky Představení
rozhraní API pro ASP.NET Core webapiaot [C#] Webové/ webové rozhraní API, rozhraní API/ služba 8.0
řadič rozhraní API ASP.NET Core apicontroller [C#] Web/ASP.NET 8.0
prázdné jádro ASP.NET web [C#], F# Web/Empty 1.0
Webové rozhraní API ASP.NET Core webapi [C#], F# Webové/ webové rozhraní API, rozhraní API, služba/ WebAPI 1.0
ASP.NET Základní webová aplikace (model –View-Controller) mvc [C#], F# Web/MVC 1.0
ASP.NET Core Web App webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
služba ASP.NET Core gRPC grpc [C#] Web/gRPC 3,0
Blazor Webová aplikace blazor [C#] Webové/Blazor 8.0.100
Blazor WebAssembly Samostatná aplikace blazorwasm [C#] Web/Blazor//WebAssembly/PWA 3.1.300
Knihovna tříd classlib [C#], F#, VB Společné/knihovna 1.0
Konzolová aplikace console [C#], F#, VB Společná/konzola 1.0
Soubor Directory.Build.props buildprops Config 8.0.100
Soubor Directory.Build.targets buildtargets Config 8.0.100
Soubor manifestu místního nástroje Dotnet tool-manifest Config 3,0
Soubor EditorConfig editorconfig Config 6.0
Soubor .gitignore gitignore Config 3,0
global.json soubor globaljson Config 2.0
Test MSTest – třída mstest-class [C#], F#, VB Test/MSTest 1.0
Projekt testů MSTest mstest [C#], F#, VB Test/MSTest 1.0
NUnit 3 Testovací položka nunit-test [C#], F#, VB Test/NUnit 2,2
NUnit 3 – testovací projekt nunit [C#], F#, VB Test/NUnit 2.1.400
Konfigurace NuGet nugetconfig Config 1.0
Soubor vyrovnávací paměti protokolu proto Web/gRPC 3,0
Knihovna tříd Razor razorclasslib [C#] Web/Razor/Library/Razor Class Library 2.1
Komponenta Razor razorcomponent [C#] Web/ASP.NET 3,0
Stránka Razor page [C#] Web/ASP.NET 2.0
Soubor řešení sln Řešení 1.0
Konfigurace webu webconfig Config 1.0
aplikace model model Windows Forms (WinForms) winforms [C#], VB Běžné nebo WinForms 3.0 (5.0 pro VB)
knihovna tříd model model Windows Forms (WinForms) winformslib [C#], VB Běžné nebo WinForms 3.0 (5.0 pro VB)
Pracovní služba worker [C#] Common/Worker/Web 3,0
Aplikace WPF (Windows Presentation Foundation) wpf [C#], VB Běžné nebo WPF (Windows Presentation Foundation) 3.0 (5.0 pro VB)
Knihovna tříd WPF (Windows Presentation Foundation) wpflib [C#], VB Běžné nebo WPF (Windows Presentation Foundation) 3.0 (5.0 pro VB)
Knihovna vlastních ovládacích prvků WPF (Windows Presentation Foundation) wpfcustomcontrollib [C#], VB Běžné nebo WPF (Windows Presentation Foundation) 3.0 (5.0 pro VB)
Knihovna uživatelských ovládacích prvků WPF (Windows Presentation Foundation) wpfusercontrollib [C#], VB Běžné nebo WPF (Windows Presentation Foundation) 3.0 (5.0 pro VB)
Testovací projekt xUnit xunit [C#], F#, VB Test/xUnit 1.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0

buildprops

Vytvoří soubor Directory.Build.props pro přizpůsobení vlastností NÁSTROJE MSBuild pro celý strom složek. Další informace najdete v tématu Přizpůsobení sestavení.

  • --inherit

    Pokud je zadáno, přidá element Import pro nejbližší soubor Directory.Build.props v nadřazené adresářové hierarchii. Ve výchozím nastavení soubory Directory.Build.props nedědí z nadřazených adresářů, takže povolením této možnosti můžete vytvořit hierarchii přizpůsobení složky po složce.

  • --use-artifacts

    Pokud je zadáno, přidá vlastnost, která povolí rozložení výstupu artefaktů. Toto je běžný vzor pro projekty, které vytvářejí artefakty sestavení, jako jsou balíčky NuGet, které jsou umístěny ve společné struktuře složek. Další informace najdete v tématu Rozložení výstupu Artefakty.

buildtargets

Vytvoří soubor Directory.Build.targets pro přizpůsobení cílů a úkolů nástroje MSBuild pro celý strom složek. Další informace najdete v tématu Přizpůsobení sestavení.

  • --inherit

    Pokud je zadáno, přidá prvek Import pro nejbližší soubor Directory.Build.targets v nadřazené hierarchii adresáře. Soubory Directory.Build.targets ve výchozím nastavení nedědí z nadřazených adresářů, takže povolením této možnosti můžete vytvořit hierarchii přizpůsobení složky po složce.

console

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle verze sady SDK, kterou používáte:

    Verze sady SDK Výchozí hodnota
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0

    Možnost vytvořit projekt pro starší TFM závisí na tom, jestli je tato verze sady SDK nainstalovaná. Pokud máte například nainstalovanou jenom sadu .NET 9 SDK, je --frameworkjedinou dostupnou hodnotou pro net9.0 . Pokud například nainstalujete sadu .NET 8 SDK, bude hodnota net8.0 k dispozici pro --framework. Zadáním --framework net8.0 můžete cílit na .NET 8 i při spuštění dotnet new v sadě .NET 9 SDK.

    Pokud chcete také vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, můžete to udělat instalací balíčku NuGet pro šablonu. Běžné typy projektů web a SPA používají různé balíčky pro moniker cílové architektury (TFM). Chcete-li například vytvořit console projekt, který cílí netcoreapp1.0, spustit dotnet new install na Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    LangVersion Nastaví vlastnost v vytvořeném souboru projektu. Můžete například použít --langVersion 7.3 jazyk C# 7.3. Jazyk F# není podporován.

    Seznam výchozích verzí jazyka C# najdete v tématu Výchozí hodnoty.

  • --no-restore

    Pokud je zadáno, neprovádí implicitní obnovení během vytváření projektu.

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false. K dispozici pouze pro jazyk C#.

classlib

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit. Hodnoty: net9.0, net8.0nebo net7.0 vytvořit knihovnu tříd .NET nebo netstandard2.1netstandard2.0 vytvořit knihovnu tříd .NET Standard. Výchozí hodnota sady .NET SDK 9.0.x je net9.0.

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --langVersion <VERSION_NUMBER>

    LangVersion Nastaví vlastnost v vytvořeném souboru projektu. Můžete například použít --langVersion 7.3 jazyk C# 7.3. Jazyk F# není podporován.

    Seznam výchozích verzí jazyka C# najdete v tématu Výchozí hodnoty.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

wpf, wpflib, , wpfcustomcontrollibwpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit. Pro sadu .NET 9 SDK je výchozí hodnota net9.0.

  • --langVersion <VERSION_NUMBER>

    LangVersion Nastaví vlastnost v vytvořeném souboru projektu. Můžete například použít --langVersion 7.3 jazyk C# 7.3.

    Seznam výchozích verzí jazyka C# najdete v tématu Výchozí hodnoty.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    LangVersion Nastaví vlastnost v vytvořeném souboru projektu. Můžete například použít --langVersion 7.3 jazyk C# 7.3.

    Seznam výchozích verzí jazyka C# najdete v tématu Výchozí hodnoty.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit. Výchozí hodnota sady .NET 9 SDK je net9.0.

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

mstest

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Možnost vytvořit projekt pro starší TFM závisí na tom, jestli je tato verze sady SDK nainstalovaná. Pokud máte například nainstalovanou jenom sadu .NET 9 SDK, je --frameworkjedinou dostupnou hodnotou pro net9.0 . Pokud instalujete například sadu .NET 8 SDK, bude hodnota net8.0 dostupná pro --framework. Zadáním --framework net8.0 můžete cílit na .NET 8 i při spuštění dotnet new v sadě .NET 9 SDK.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --sdk

    Použijte styl projektu MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    Spouštěč/platforma pro testovací projekt. Možné hodnoty:

    • VSTest – Platforma VSTest (výchozí).
    • MSTest - Microsoft. Testing.Platform (MTP).

  • --coverage-tool <COVERAGE_TOOL>

    Nástroj pokrytí, který se má použít pro testovací projekt. Možné hodnoty:

    • Microsoft.CodeCoverage – Pokrytí kódu Microsoftu (výchozí).
    • coverlet - nástroj pokrytí krytu.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Profil rozšíření SADY SDK při použití MTP. Možné hodnoty:

    • Default – Výchozí profil rozšíření (Výchozí).
    • None – Nejsou povolena žádná rozšíření.
    • AllMicrosoft – Povolí všechna rozšíření dodávaná Microsoftem (včetně rozšíření s omezující licencí).

  • --fixture <FIXTURE>

    Druhy zařízení, které mají být zahrnuty do testovacího projektu. Možné hodnoty:

    • None - Žádné metody zařízení.
    • AssemblyInitialize - AssemblyInitialize metoda zařízení.
    • AssemblyCleanup - Metoda montáže AssemblyCleanup.
    • ClassInitialize - Metoda zařízení ClassInitialize.
    • ClassCleanup - Metoda zařízení ClassCleanup.
    • TestInitialize - Metoda zařízení TestInitialize.
    • TestCleanup - Metoda zařízení TestCleanup.

    Kde je povoleno více hodnot.

  • -p|--enable-pack

    Umožňuje balení pro projekt pomocí balíčku dotnet Pack.

mstest-class

  • --fixture <FIXTURE>

    Druhy zařízení, které mají být zahrnuty do testovacího projektu. Možné hodnoty:

    • None - Žádné metody zařízení.
    • AssemblyInitialize - AssemblyInitialize metoda zařízení.
    • AssemblyCleanup - Metoda montáže AssemblyCleanup.
    • ClassInitialize - Metoda zařízení ClassInitialize.
    • ClassCleanup - Metoda zařízení ClassCleanup.
    • TestInitialize - Metoda zařízení TestInitialize.
    • TestCleanup - Metoda zařízení TestCleanup.

    Kde je povoleno více hodnot.

xunit

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Možnost vytvořit projekt pro starší TFM závisí na tom, jestli je tato verze sady SDK nainstalovaná. Pokud máte například nainstalovanou jenom sadu .NET 9 SDK, je --frameworkjedinou dostupnou hodnotou pro net9.0 . Pokud instalujete například sadu .NET 8 SDK, bude hodnota net8.0 dostupná pro --framework. Zadáním --framework net8.0 můžete cílit na .NET 8 i při spuštění dotnet new v sadě .NET 9 SDK.

  • -p|--enable-pack

    Umožňuje balení pro projekt pomocí balíčku dotnet Pack.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

nunit

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Možnost vytvořit projekt pro starší TFM závisí na tom, jestli je tato verze sady SDK nainstalovaná. Pokud máte například nainstalovanou jenom sadu .NET 9 SDK, je --frameworkjedinou dostupnou hodnotou pro net9.0 . Pokud instalujete například sadu .NET 8 SDK, bude hodnota net8.0 dostupná pro --framework. Zadáním --framework net8.0 můžete cílit na .NET 8 i při spuštění dotnet new v sadě .NET 9 SDK.

  • -p|--enable-pack

    Umožňuje balení pro projekt pomocí balíčku dotnet Pack.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

page

  • -na|--namespace <NAMESPACE_NAME>

    Obor názvů pro vygenerovaný kód Výchozí hodnota je MyApp.Namespace.

  • -np|--no-pagemodel

    Vytvoří stránku bez modelu PageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Obor názvů pro vygenerovaný kód Výchozí hodnota je MyApp.Namespace.

blazor

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Tato šablona je k dispozici pro .NET 8 nebo novější.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované aplikace.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Určuje, který interaktivní režim vykreslování se má použít pro interaktivní komponenty. Možné hodnoty:

    • None – Žádná interaktivita (pouze statické vykreslování na straně serveru).
    • Server – (Výchozí) Spustí aplikaci na serveru s interaktivním vykreslováním na straně serveru.
    • WebAssembly - Spustí aplikaci pomocí vykreslování na straně klienta v prohlížeči s WebAssembly.
    • Auto- Používá interaktivní vykreslování na straně serveru při stahování Blazor sady a aktivaci Blazor modulu runtime na klientovi a následné použití vykreslování na straně klienta .WebAssembly

  • --empty

    Vynechá ukázkové stránky a styly, které demonstrují základní vzory použití.

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít. Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • Individual - Individuální ověřování.

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na Individual ověřování.

  • -ai|--all-interactive

    Zpřístupňuje každou stránku interaktivně použitím interaktivního režimu vykreslování na nejvyšší úrovni. Pokud falsestránky ve výchozím nastavení používají statické vykreslování na straně serveru a dají se označit interaktivně na jednotlivých stránkách nebo jednotlivých součástech. Tato možnost je platná pouze v případě, -i|--interactivity že tato možnost není nastavená na Nonehodnotu .

  • --no-https

    Vypne HTTPS. Tato možnost platí jenom v případě Individual , že není zvolena pro tuto -au|--auth možnost.

  • --use-program-main

    Pokud je zadána, explicitní Program třída a Main metoda se vygenerují místo příkazů nejvyšší úrovně.

web

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --no-https

    Vypne HTTPS.

  • --kestrelHttpPort

    Číslo portu, které se má použít pro koncový bod HTTP v launchSettings.json

  • --kestrelHttpsPort

    Číslo portu, které se má použít pro koncový bod HTTPS v launchSettings.json Tato možnost není použitelná při použití parametru no-https (ale no-https je ignorována při výběru --authnastavení ověřování jednotlivce nebo organizace).

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít. Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • Individual - Individuální ověřování.
    • IndividualB2C – Individuální ověřování pomocí Azure AD B2C.
    • SingleOrg – Ověřování organizace pro jednoho tenanta. Tenanti Entra External ID také používají SingleOrg.
    • MultiOrg – Ověřování organizace pro více tenantů
    • Windows – Ověřování systému Windows.

  • --aad-b2c-instance <INSTANCE>

    Instance Azure Active Directory B2C, ke které se chcete připojit. Používá se s ověřováním IndividualB2C . Výchozí hodnota je https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    ID zásad přihlašování a registrace pro tento projekt. Používá se s ověřováním IndividualB2C .

  • -rp|--reset-password-policy-id <ID>

    ID zásady resetování hesla pro tento projekt. Používá se s ověřováním IndividualB2C .

  • -ep|--edit-profile-policy-id <ID>

    ID zásady úprav profilu pro tento projekt. Používá se s ověřováním IndividualB2C .

  • --aad-instance <INSTANCE>

    Instance Azure Active Directory, ke které se chcete připojit. Používá se s ověřováním nebo SingleOrg s ověřovánímMultiOrg. Výchozí hodnota je https://login.microsoftonline.com/.

  • --client-id <ID>

    ID klienta pro tento projekt. Používá se s IndividualB2C, SingleOrgnebo MultiOrg ověřováním. Výchozí hodnota je 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Doména pro tenanta adresáře. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je qualified.domain.name.

  • --tenant-id <ID>

    ID tenanta adresáře, ke kterému se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Cesta požadavku v rámci základní cesty aplikace identifikátoru URI přesměrování. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je /signin-oidc.

  • -r|--org-read-access

    Umožňuje této aplikaci přístup pro čtení do adresáře. Vztahuje se pouze na SingleOrg ověřování nebo MultiOrg na ověřování.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • --no-https

    Vypne HTTPS. Tato možnost platí jenom v případě, Individualže IndividualB2Cse nepoužívá , SingleOrgnebo MultiOrg se nepoužívá.

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na Individual ověřování nebo IndividualB2C na ověřování.

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --use-browserlink

    Zahrnuje BrowserLink v projektu.

  • -rrc|--razor-runtime-compilation

    Určuje, jestli je projekt nakonfigurovaný tak, aby používal kompilaci modulu runtime Razor v buildech Ladění.

  • --kestrelHttpPort

    Číslo portu, které se má použít pro koncový bod HTTP v launchSettings.json

  • --kestrelHttpsPort

    Číslo portu, které se má použít pro koncový bod HTTPS v launchSettings.json Tato možnost není použitelná při použití parametru no-https (ale no-https je ignorována při výběru --authnastavení ověřování jednotlivce nebo organizace).

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

razorclasslib

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • -s|--support-pages-and-views

    Podporuje přidání tradičních stránek Razor Pages a Zobrazení kromě komponent do této knihovny.

webapiaot

Vytvoří projekt webového rozhraní API s povoleným publikováním AOT. Další informace najdete v tématu Nativní nasazení AOT a šablona webového rozhraní API (Nativní AOT).

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít. Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • IndividualB2C – Individuální ověřování pomocí Azure AD B2C.
    • SingleOrg – Ověřování organizace pro jednoho tenanta. Tenanti Entra External ID také používají SingleOrg.
    • Windows – Ověřování systému Windows.

  • --aad-b2c-instance <INSTANCE>

    Instance Azure Active Directory B2C, ke které se chcete připojit. Používá se s ověřováním IndividualB2C . Výchozí hodnota je https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Vytvořte projekt, který používá minimální rozhraní API ASP.NET Core. Výchozí hodnota je false, ale tato možnost je přepsána -controllers. Vzhledem k tomu, že výchozí hodnota -controllers je false, zadávání dotnet new webapi bez zadání obou možností vytvoří minimální projekt rozhraní API.

  • -ssp|--susi-policy-id <ID>

    ID zásad přihlašování a registrace pro tento projekt. Používá se s ověřováním IndividualB2C .

  • --aad-instance <INSTANCE>

    Instance Azure Active Directory, ke které se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je https://login.microsoftonline.com/.

  • --client-id <ID>

    ID klienta pro tento projekt. Používá se s ověřováním nebo IndividualB2C s ověřovánímSingleOrg. Výchozí hodnota je 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Zda použít kontrolery místo minimálních rozhraní API. Pokud je tato možnost i -minimal zadaná, tato možnost přepíše hodnotu určenou parametrem -minimal. Výchozí hodnota je false. K dispozici od sady .NET 8 SDK.

  • --domain <DOMAIN>

    Doména pro tenanta adresáře. Používá se s ověřováním nebo IndividualB2C s ověřovánímSingleOrg. Výchozí hodnota je qualified.domain.name.

  • --tenant-id <ID>

    ID tenanta adresáře, ke kterému se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Umožňuje této aplikaci přístup pro čtení do adresáře. Vztahuje se pouze na SingleOrg ověřování.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • --no-openapi

    Vypne podporu OpenAPI (Swagger). AddOpenApi a MapOpenApi nevolá se.

  • --no-https

    Vypne HTTPS. V souboru .> se nevytvořil žádný launchSettings.json. app.UseHstsa app.UseHttpsRedirection nejsou volána v Program.cs Startup.cs/. Tato možnost platí jenom v případě, IndividualB2C že SingleOrg se nepoužívá k ověřování.

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na IndividualB2C ověřování.

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

apicontroller

Kontroler rozhraní API s akcemi čtení a zápisu nebo bez.

  • -p:n|--name <NAME>

    Obor názvů pro vygenerovaný kód. Výchozí hodnota je MyApp.Namespace.

  • -ac|--actions

    Vytvořte kontroler s akcemi čtení a zápisu. Výchozí hodnota je false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Určuje verzi sady .NET SDK, která se má použít v souboru global.json .

  • --roll-forward <ROLL_FORWARD_POLICY>

    Zásady postupného použití při výběru verze sady SDK, a to buď jako záložní, pokud chybí konkrétní verze sady SDK, nebo jako direktiva pro použití novější verze. Další informace najdete v souboru global-json.

  • --test-runner <TEST_RUNNER>

    Tato možnost byla zavedena v sadě .NET 10 SDK a určuje spouštěč testů, který se má použít, buď VSTest, nebo MTP. Výchozí hodnota je VSTest.

sln

Vytvoří prázdný soubor řešení obsahující žádné projekty.

Poznámka:

V sadě .NET SDK 9.0.200 a novějších podporuje --format tato šablona možnost výběru mezi sln formáty a slnx formáty. Počínaje rozhraním .NET 10 je slnxvýchozí formát .

editorconfig

Vytvoří soubor .editorconfig pro konfiguraci předvoleb stylu kódu.

  • --empty

    Vytvoří prázdný .editorconfig místo výchozích hodnot pro .NET.

Ukončené šablony

Následující tabulka uvádí šablony, které byly ukončeny a už nejsou předinstalované pomocí sady .NET SDK. Pokud chcete zobrazit jakékoli možnosti specifické pro šablonu, vyberte odkaz na krátký název.

Šablony Krátký název Jazyk Značky Ukončeno od
ASP.NET Core s Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core s React.js react [C#] Web/MVC/SPA 8.0
Blazor Serverová aplikace blazorserver [C#] Webové/Blazor 8.0
Blazor Prázdná serverová aplikace blazorserver-empty [C#] Webové/Blazor 8.0
Blazor WebAssembly Prázdná aplikace blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

angular, react

Ukončeno od sady .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít.

    Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • Individual - Individuální ověřování.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --no-https

    Vypne HTTPS. Tato možnost platí pouze v případě, že je Noneověřování .

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na Individual ověřování nebo IndividualB2C na ověřování.

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Poznámka:

    Neexistuje však šablona Reactu pro net8.0, pokud vás ale zajímá vývoj aplikací React s ASP.NET Core, podívejte se na přehled jednostrákových aplikací (SPA) v ASP.NET Core.

    Verze sady SDK Výchozí hodnota
    7.0 net7.0

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --kestrelHttpPort

    Číslo portu, které se má použít pro koncový bod HTTP v launchSettings.json

  • --kestrelHttpsPort

    Číslo portu, které se má použít pro koncový bod HTTPS v launchSettings.json Tato možnost není použitelná při použití parametru no-https (ale no-https je ignorována při výběru --authnastavení ověřování jednotlivce nebo organizace).

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

blazorserver

Ukončeno od sady .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít. Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • Individual - Individuální ověřování.
    • IndividualB2C – Individuální ověřování pomocí Azure AD B2C.
    • SingleOrg – Ověřování organizace pro jednoho tenanta. Klienti Entra External ID také používají SingleOrg.
    • MultiOrg – Ověřování organizace pro více tenantů
    • Windows – Ověřování systému Windows.

  • --aad-b2c-instance <INSTANCE>

    Instance Azure Active Directory B2C, ke které se chcete připojit. Používá se s ověřováním IndividualB2C . Výchozí hodnota je https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    ID zásad přihlašování a registrace pro tento projekt. Používá se s ověřováním IndividualB2C .

  • -rp|--reset-password-policy-id <ID>

    ID zásady resetování hesla pro tento projekt. Používá se s ověřováním IndividualB2C .

  • -ep|--edit-profile-policy-id <ID>

    ID zásady úprav profilu pro tento projekt. Používá se s ověřováním IndividualB2C .

  • --aad-instance <INSTANCE>

    Instance Azure Active Directory, ke které se chcete připojit. Používá se s ověřováním nebo SingleOrg s ověřovánímMultiOrg. Výchozí hodnota je https://login.microsoftonline.com/.

  • --client-id <ID>

    ID klienta pro tento projekt. Používá se s IndividualB2C, SingleOrgnebo MultiOrg ověřováním. Výchozí hodnota je 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Doména pro tenanta adresáře. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je qualified.domain.name.

  • --tenant-id <ID>

    ID tenanta adresáře, ke kterému se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Cesta požadavku v rámci základní cesty aplikace identifikátoru URI přesměrování. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je /signin-oidc.

  • -r|--org-read-access

    Umožňuje této aplikaci přístup pro čtení do adresáře. Vztahuje se pouze na SingleOrg ověřování nebo MultiOrg na ověřování.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • --no-https

    Vypne HTTPS. Tato možnost se použije pouze v případě, IndividualIndividualB2CSingleOrgže MultiOrgse pro .--auth

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na Individual ověřování nebo IndividualB2C na ověřování.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • --kestrelHttpPort

    Číslo portu, které se má použít pro koncový bod HTTP v launchSettings.json

  • --kestrelHttpsPort

    Číslo portu, které se má použít pro koncový bod HTTPS v launchSettings.json Tato možnost není použitelná při použití parametru no-https (ale no-https je ignorována při výběru --authnastavení ověřování jednotlivce nebo organizace).

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Určuje architekturu, která se má cílit.

    Následující tabulka uvádí výchozí hodnoty podle čísla verze sady SDK, které používáte:

    Verze sady SDK Výchozí hodnota
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Pokud chcete vytvořit projekt, který cílí na architekturu starší než sada SDK, kterou používáte, podívejte --framework se na console projekty uvedené výše v tomto článku.

  • --no-restore

    Při vytváření projektu se nespustí implicitní obnovení.

  • -ho|--hosted

    Zahrnuje hostitele ASP.NET Core pro BlazorWebAssembly aplikaci.

  • -au|--auth <AUTHENTICATION_TYPE>

    Typ ověřování, který se má použít. Možné hodnoty:

    • None – Žádné ověřování (výchozí).
    • Individual - Individuální ověřování.
    • IndividualB2C – Individuální ověřování pomocí Azure AD B2C.
    • SingleOrg – Ověřování organizace pro jednoho tenanta. Tenanti Entra External ID také používají SingleOrg.

  • --authority <AUTHORITY>

    Autorita poskytovatele OIDC. Používá se s ověřováním Individual . Výchozí hodnota je https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Instance Azure Active Directory B2C, ke které se chcete připojit. Používá se s ověřováním IndividualB2C . Výchozí hodnota je https://aadB2CInstance.b2clogin.com/.

  • -ssp|--susi-policy-id <ID>

    ID zásad přihlašování a registrace pro tento projekt. Používá se s ověřováním IndividualB2C .

  • --aad-instance <INSTANCE>

    Instance Azure Active Directory, ke které se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je https://login.microsoftonline.com/.

  • --client-id <ID>

    ID klienta pro tento projekt. Používá se se službou IndividualB2C, SingleOrgnebo Individual ověřováním v samostatných scénářích. Výchozí hodnota je 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Doména pro tenanta adresáře. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je qualified.domain.name.

  • --app-id-uri <URI>

    Identifikátor URI ID aplikace pro rozhraní API serveru, které chcete volat. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je api.id.uri.

  • --api-client-id <ID>

    ID klienta pro rozhraní API, které server hostuje. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je 11111111-1111-1111-11111111111111111.

  • -s|--default-scope <SCOPE>

    Obor rozhraní API, které klient potřebuje k zřízení přístupového tokenu. Používá se s ověřováním nebo SingleOrg s ověřovánímIndividualB2C. Výchozí hodnota je user_impersonation.

  • --tenant-id <ID>

    ID tenanta adresáře, ke kterému se chcete připojit. Používá se s ověřováním SingleOrg . Výchozí hodnota je 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Umožňuje této aplikaci přístup pro čtení do adresáře. Vztahuje se pouze na SingleOrg ověřování.

  • --exclude-launch-settings

    Vyloučí launchSettings.json z vygenerované šablony.

  • -p|--pwa

    vytváří progresivní webovou aplikaci (PWA) podporující instalaci a offline použití.

  • --no-https

    Vypne HTTPS. Tato možnost se použije pouze v případě, IndividualIndividualB2Cže SingleOrgse nepoužívá pro --auth.

  • -uld|--use-local-db

    Určuje, že se má použít LocalDB místo SQLite. Vztahuje se pouze na Individual ověřování nebo IndividualB2C na ověřování.

  • --called-api-url <URL>

    Adresa URL rozhraní API pro volání z webové aplikace Platí pouze pro SingleOrg nebo IndividualB2C ověřování bez zadaného hostitele ASP.NET Core. Výchozí hodnota je https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Určuje, jestli webová aplikace volá Microsoft Graph. Vztahuje se pouze na SingleOrg ověřování.

  • --called-api-scopes <SCOPES>

    Obory pro vyžádání volání rozhraní API z webové aplikace Platí pouze pro SingleOrg nebo IndividualB2C ověřování bez zadaného hostitele ASP.NET Core. Výchozí hodnota je user.read.

  • --kestrelHttpPort

    Číslo portu, které se má použít pro koncový bod HTTP v launchSettings.json

  • --kestrelHttpsPort

    Číslo portu, které se má použít pro koncový bod HTTPS v launchSettings.json Tato možnost není použitelná při použití parametru no-https (ale no-https je ignorována při výběru --authnastavení ověřování jednotlivce nebo organizace).

  • --use-program-main

    Pokud je zadána, použije se explicitní Program třída a Main metoda místo příkazů nejvyšší úrovně. K dispozici od sady .NET SDK 6.0.300. Výchozí hodnota: false.

Viz také

  • Last updated on