Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Standaardsjablonen voor
Wanneer u de .NET SDK installeert, ontvangt u meer dan tien ingebouwde sjablonen voor het maken van projecten en bestanden, waaronder console-apps, klassebibliotheken, eenheidstestprojecten, ASP.NET Core-apps (inclusief Angular - en React-projecten ) en configuratiebestanden. Voer de dotnet new list opdracht uit om de ingebouwde sjablonen weer te geven:
dotnet new list
Sjabloonopties
De sjablonen die worden verzonden met de .NET SDK, hebben sjabloonspecifieke opties. Als u de extra opties wilt weergeven die beschikbaar zijn voor de sjabloon, gebruikt u de --help optie met het argument sjabloonnaam, bijvoorbeeld: dotnet new console --help In de sjabloonspecifieke secties in dit artikel worden ook de opties beschreven.
Als de sjabloon meerdere programmeertalen ondersteunt, wordt met de --help optie help weergegeven voor de sjabloon in de standaardtaal. Door deze te combineren met de --language optie, kunt u de Help voor andere talen bekijken: dotnet new console --help --language F#.
Vooraf geïnstalleerde sjablonen
In de volgende tabel ziet u de sjablonen die vooraf zijn geïnstalleerd met de .NET SDK. De standaardtaal voor de sjabloon wordt tussen vierkante haken weergegeven. Als u sjabloonspecifieke opties wilt zien, selecteert u de korte naamkoppeling.
| Sjablonen | Korte naam | Taal | Tags | Geïntroduceerd |
|---|---|---|---|---|
| ASP.NET Core-API | webapiaot |
[C#] | Web/Web-API/API/SERVICE | 8.0 |
| ASP.NET Core API-controller | apicontroller |
[C#] | Web/ASP.NET | 8.0 |
| ASP.NET Core leeg | web |
[C#], F# | Web/leeg | 1.0 |
| ASP.NET Core Web-API | webapi |
[C#], F# | Web/Web-API/API/Service/WebAPI | 1.0 |
| ASP.NET Core-web-app (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 |
| ASP.NET Core gRPC-service | grpc |
[C#] | Web/gRPC | 3,0 |
| Blazor Web-app | blazor |
[C#] | Web/Blazor | 8.0.100 |
| Blazor WebAssembly Zelfstandige app | blazorwasm |
[C#] | Web/Blazor//WebAssemblyPWA | 3.1.300 |
| Klassebibliotheek | classlib |
[C#], F#, VB | Algemeen/Bibliotheek | 1.0 |
| Console toepassing | console |
[C#], F#, VB | Algemeen/Console | 1.0 |
| Map.Build.props-bestand | buildprops |
Configureren | 8.0.100 | |
| Bestand Directory.Build.targets | buildtargets |
Configureren | 8.0.100 | |
| Manifestbestand van het lokale hulpprogramma Dotnet | tool-manifest |
Configureren | 3,0 | |
| EditorConfig-bestand | editorconfig |
Configureren | 6,0 | |
| .gitignore-bestand | gitignore |
Configureren | 3,0 | |
| global.json-bestand | globaljson |
Configureren | 2.0 | |
| MSTest-testklasse | mstest-class |
[C#], F#, VB | Testen/MSTest | 1.0 |
| MSTest-testproject | mstest |
[C#], F#, VB | Testen/MSTest | 1.0 |
| Testitem NUnit 3 | nunit-test |
[C#], F#, VB | Test/NUnit | 2.2 |
| Testproject NUnit 3 | nunit |
[C#], F#, VB | Test/NUnit | 2.1.400 |
| NuGet-configuratie | nugetconfig |
Configureren | 1.0 | |
| Protocolbufferbestand | proto |
Web/gRPC | 3,0 | |
| Razor-klassebibliotheek | razorclasslib |
[C#] | Web/Razor/Library/Razor Class Library | 2.1 |
| Razor-onderdeel | razorcomponent |
[C#] | Web/ASP.NET | 3,0 |
| Razor-pagina | page |
[C#] | Web/ASP.NET | 2.0 |
| Oplossingsbestand | sln |
Oplossing | 1.0 | |
| Webconfiguratie | webconfig |
Configureren | 1.0 | |
| Windows Forms-toepassing (WinForms) | winforms |
[C#], VB | Algemene/WinForms | 3.0 (5.0 voor VB) |
| Windows Forms -klassebibliotheek (WinForms) | winformslib |
[C#], VB | Algemene/WinForms | 3.0 (5.0 voor VB) |
| Werkrolservice | worker |
[C#] | Common/Worker/Web | 3,0 |
| WPF-toepassing | wpf |
[C#], VB | Algemeen/WPF | 3.0 (5.0 voor VB) |
| WPF Class-bibliotheek | wpflib |
[C#], VB | Algemeen/WPF | 3.0 (5.0 voor VB) |
| Aangepaste WPF-besturingselementbibliotheek | wpfcustomcontrollib |
[C#], VB | Algemeen/WPF | 3.0 (5.0 voor VB) |
| WPF User Control Library | wpfusercontrollib |
[C#], VB | Algemeen/WPF | 3.0 (5.0 voor VB) |
| xUnit-testproject | 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
Hiermee maakt u een Map.Build.props-bestand voor het aanpassen van MSBuild-eigenschappen voor een hele mapstructuur. Zie Uw build aanpassen voor meer informatie.
--inheritAls dit is opgegeven, voegt u een importelement toe voor het dichtstbijzijnde bestand Directory.Build.props in de bovenliggende maphiërarchie. Map.Build.props-bestanden nemen standaard niet over van bovenliggende mappen, dus als u deze optie inschakelt, kunt u een hiërarchie van aanpassingen per map opbouwen.
--use-artifactsIndien opgegeven, voegt u een eigenschap toe om de uitvoerindeling voor artefacten in te schakelen. Dit is een algemeen patroon voor projecten die buildartefacten produceren, zoals NuGet-pakketten, die in een gemeenschappelijke mapstructuur worden geplaatst. Zie de indeling Artefacten-uitvoer voor meer informatie.
buildtargets
Hiermee maakt u een bestand Directory.Build.targets voor het aanpassen van MSBuild-doelen en -taken voor een hele mapstructuur. Zie Uw build aanpassen voor meer informatie.
--inheritAls dit is opgegeven, voegt u een importelement toe voor het dichtstbijzijnde bestand Directory.Build.targets in de bovenliggende maphiërarchie. Map.Build.targets-bestanden nemen standaard niet over van bovenliggende mappen, dus als u deze optie inschakelt, kunt u een hiërarchie van aanpassingen per map opbouwen.
console
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van de SDK-versie die u gebruikt:
SDK-versie Standaardwaarde 9.0 net9.08.0 net8.07.0 net7.0De mogelijkheid om een project voor een eerdere TFM te maken, is afhankelijk van het installeren van die versie van de SDK. Als u bijvoorbeeld alleen de .NET 9 SDK hebt geïnstalleerd, is de enige waarde die beschikbaar is voor
--frameworknet9.0. Als u bijvoorbeeld de .NET 8 SDK installeert, is de waardenet8.0beschikbaar voor--framework. Als u dus--framework net8.0opgeeft, kunt u .NET 8 zelfs targeten tijdens het uitvoeren vandotnet newin de .NET 9 SDK.Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, kunt u dit mogelijk doen door het NuGet-pakket voor de sjabloon te installeren. Algemene projecttypen web en BEVEILIGD-WACHTWOORDVERIFICATIE maken gebruik van verschillende pakketten per target framework moniker (TFM). Als u bijvoorbeeld een
consoleproject wilt maken dat is gerichtnetcoreapp1.0op , voert u deze uitdotnet new installMicrosoft.DotNet.Common.ProjectTemplates.1.x.--langVersion <VERSION_NUMBER>Hiermee stelt u de
LangVersioneigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld--langVersion 7.3C# 7.3. Niet ondersteund voor F#.Zie Defaults voor een lijst met standaard C#-versies.
--no-restoreAls dit is opgegeven, wordt er geen impliciete herstelbewerking uitgevoerd tijdens het maken van het project.
--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false. Alleen beschikbaar voor C#.
classlib
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht. Waarden:
net9.0,net8.0ofnet7.0om een .NET-klassebibliotheek te maken ofnetstandard2.1netstandard2.0om een .NET Standard-klassebibliotheek te maken. De standaardwaarde voor .NET SDK 9.0.x isnet9.0.Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--langVersion <VERSION_NUMBER>Hiermee stelt u de
LangVersioneigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld--langVersion 7.3C# 7.3. Niet ondersteund voor F#.Zie Defaults voor een lijst met standaard C#-versies.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
wpf, , , wpflibwpfcustomcontrollibwpfusercontrollib
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht. Voor de .NET 9 SDK is de standaardwaarde
net9.0.--langVersion <VERSION_NUMBER>Hiermee stelt u de
LangVersioneigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld--langVersion 7.3C# 7.3.Zie Defaults voor een lijst met standaard C#-versies.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
winforms, winformslib
--langVersion <VERSION_NUMBER>Hiermee stelt u de
LangVersioneigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld--langVersion 7.3C# 7.3.Zie Defaults voor een lijst met standaard C#-versies.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
worker, grpc
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht. De standaardwaarde voor .NET 9 SDK is
net9.0.Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
mstest
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0
De mogelijkheid om een project voor een eerdere TFM te maken, is afhankelijk van het installeren van die versie van de SDK. Als u bijvoorbeeld alleen de .NET 9 SDK hebt geïnstalleerd, is de enige waarde die beschikbaar is voor --frameworknet9.0. Als u bijvoorbeeld de .NET 8 SDK installeert, is de waarde net8.0 beschikbaar voor --framework. Als u dus --framework net8.0 opgeeft, kunt u .NET 8 zelfs targeten tijdens het uitvoeren van dotnet new in de .NET 9 SDK.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--sdkGebruik de projectstijl MSTest.Sdk.
--test-runner <TEST_RUNNER>De runner/platform voor het testproject. Mogelijke waarden zijn:
-
VSTest- VSTest-platform (standaard). -
MSTest- Microsoft.Testing.Platform.
-
--coverage-tool <COVERAGE_TOOL>Het dekkingsprogramma dat moet worden gebruikt voor het testproject. Mogelijke waarden zijn:
-
Microsoft.CodeCoverage- Microsoft Code-dekking (standaard). -
coverlet- dekkingsprogramma voor coverlet.
-
--extensions-profile <EXTENSIONS_PROFILE>Het PROFIEL voor SDK-extensies bij het gebruik van Microsoft.Testing.Platform. Mogelijke waarden zijn:
-
Default- Profiel voor standaardextensies (standaard). -
None- Er zijn geen extensies ingeschakeld. -
AllMicrosoft- Schakel alle extensies in die door Microsoft worden verzonden (inclusief extensies met een beperkende licentie).
-
--fixture <FIXTURE>De armaturen die in het testproject moeten worden opgenomen. Mogelijke waarden zijn:
-
None- Geen armaturenmethoden. -
AssemblyInitialize- AssemblyInitialize armatuurmethode. -
AssemblyCleanup- AssemblyCleanup armaturenmethode. -
ClassInitialize- Methode ClassInitialize-armaturen. -
ClassCleanup- Methode ClassCleanup-armaturen. -
TestInitialize- TestInitialize armatuurmethode. -
TestCleanup- TestCleanup armaturenmethode.
Waarbij meerdere waarden zijn toegestaan.
-
-p|--enable-packMaakt het inschakelen van pakketten voor het project met behulp van dotnet pack.
mstest-class
--fixture <FIXTURE>De armaturen die in het testproject moeten worden opgenomen. Mogelijke waarden zijn:
-
None- Geen armaturenmethoden. -
AssemblyInitialize- AssemblyInitialize armatuurmethode. -
AssemblyCleanup- AssemblyCleanup armaturenmethode. -
ClassInitialize- Methode ClassInitialize-armaturen. -
ClassCleanup- Methode ClassCleanup-armaturen. -
TestInitialize- TestInitialize armatuurmethode. -
TestCleanup- TestCleanup armaturenmethode.
Waarbij meerdere waarden zijn toegestaan.
-
xunit
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0
De mogelijkheid om een project voor een eerdere TFM te maken, is afhankelijk van het installeren van die versie van de SDK. Als u bijvoorbeeld alleen de .NET 9 SDK hebt geïnstalleerd, is de enige waarde die beschikbaar is voor --frameworknet9.0. Als u bijvoorbeeld de .NET 8 SDK installeert, is de waarde net8.0 beschikbaar voor --framework. Als u dus --framework net8.0 opgeeft, kunt u .NET 8 zelfs targeten tijdens het uitvoeren van dotnet new in de .NET 9 SDK.
-p|--enable-packMaakt het inschakelen van pakketten voor het project met behulp van dotnet pack.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
nunit
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0
De mogelijkheid om een project voor een eerdere TFM te maken, is afhankelijk van het installeren van die versie van de SDK. Als u bijvoorbeeld alleen de .NET 9 SDK hebt geïnstalleerd, is de enige waarde die beschikbaar is voor --frameworknet9.0. Als u bijvoorbeeld de .NET 8 SDK installeert, is de waarde net8.0 beschikbaar voor --framework. Als u dus --framework net8.0 opgeeft, kunt u .NET 8 zelfs targeten tijdens het uitvoeren van dotnet new in de .NET 9 SDK.
-p|--enable-packMaakt het inschakelen van pakketten voor het project met behulp van dotnet pack.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
page
-na|--namespace <NAMESPACE_NAME>Naamruimte voor de gegenereerde code. De standaardwaarde is
MyApp.Namespace.-np|--no-pagemodelHiermee maakt u de pagina zonder PageModel.
viewimports, proto
-na|--namespace <NAMESPACE_NAME>Naamruimte voor de gegenereerde code. De standaardwaarde is
MyApp.Namespace.
blazor
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
Deze sjabloon is beschikbaar voor .NET 8 of hoger.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde app.
-int|--interactivity <None|Server|Webassembly|Auto >Hiermee geeft u op welke interactieve rendermodus moet worden gebruikt voor interactieve onderdelen. Mogelijke waarden zijn:
-
None- Geen interactiviteit (alleen statische rendering aan serverzijde). -
Server- (Standaard) Hiermee wordt de app uitgevoerd op de server met interactieve rendering aan de serverzijde. -
WebAssembly- Hiermee wordt de app uitgevoerd met behulp van client-side rendering in de browser met WebAssembly. -
Auto- Maakt gebruik van interactieve rendering aan de serverzijde tijdens het downloaden van de Blazor bundel en het activeren van de Blazor runtime op de client, en gebruikt vervolgens rendering aan de clientzijde met WebAssembly.
-
--emptyLaat voorbeeldpagina's en stijl weg die basisgebruikspatronen demonstreren.
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt. Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
Individual- Afzonderlijke verificatie.
-
-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
Individualverificatie.-ai|--all-interactiveMaakt elke pagina interactief door een interactieve rendermodus toe te passen op het hoogste niveau. Als
falsepagina's standaard statische rendering op de server gebruiken en interactief kunnen worden gemarkeerd per pagina of per onderdeel. Deze optie is alleen van kracht als de-i|--interactivityoptie niet is ingesteld opNone.--no-httpsHiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als
Individualniet voor de-au|--authoptie is gekozen.--use-program-mainIndien opgegeven, wordt een expliciete
Programklasse enMainmethode gegenereerd in plaats van instructies op het hoogste niveau.
web
--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--no-httpsHiermee schakelt u HTTPS uit.
--kestrelHttpPortPoortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.
--kestrelHttpsPortPoortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter
no-httpswordt gebruikt (maarno-httpswordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
mvc, webapp
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt. Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
Individual- Afzonderlijke verificatie. -
IndividualB2C- Afzonderlijke verificatie met Azure AD B2C. -
SingleOrg- Organisatieverificatie voor één tenant. Externe id-tenants van Entra gebruiken ook SingleOrg. -
MultiOrg- Organisatieverificatie voor meerdere tenants. -
Windows- Windows-verificatie.
-
--aad-b2c-instance <INSTANCE>Het Azure Active Directory B2C-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
IndividualB2Cverificatie. De standaardwaarde ishttps://login.microsoftonline.com/tfp/.-ssp|--susi-policy-id <ID>De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met
IndividualB2Cverificatie.-rp|--reset-password-policy-id <ID>De wachtwoordbeleids-id voor dit project opnieuw instellen. Gebruiken met
IndividualB2Cverificatie.-ep|--edit-profile-policy-id <ID>De profielbeleids-id voor dit project bewerken. Gebruiken met
IndividualB2Cverificatie.--aad-instance <INSTANCE>Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgofMultiOrgverificatie. De standaardwaarde ishttps://login.microsoftonline.com/.--client-id <ID>De client-id voor dit project. Gebruiken met
IndividualB2C,SingleOrgofMultiOrgverificatie. De standaardwaarde is11111111-1111-1111-11111111111111111.--domain <DOMAIN>Het domein voor de maptenant. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde isqualified.domain.name.--tenant-id <ID>De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde is22222222-2222-2222-2222-222222222222.--callback-path <PATH>Het aanvraagpad binnen het basispad van de omleidings-URI van de toepassing. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde is/signin-oidc.-r|--org-read-accessHiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op
SingleOrgofMultiOrgverificatie.--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
--no-httpsHiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als
Individual,IndividualB2CSingleOrgofMultiOrgniet wordt gebruikt.-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
IndividualofIndividualB2Cverificatie.-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--use-browserlinkBevat BrowserLink in het project.
-rrc|--razor-runtime-compilationBepaalt of het project is geconfigureerd voor het gebruik van Razor Runtime-compilatie in builds voor foutopsporing.
--kestrelHttpPortPoortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.
--kestrelHttpsPortPoortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter
no-httpswordt gebruikt (maarno-httpswordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
razorclasslib
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
-s|--support-pages-and-viewsOndersteunt het toevoegen van traditionele Razor-pagina's en weergaven naast onderdelen aan deze bibliotheek.
webapiaot
Hiermee maakt u een web-API-project waarvoor AOT-publicatie is ingeschakeld. Zie voor meer informatie de native AOT-implementatie en de sjabloon Voor de web-API (systeemeigen AOT).
--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
webapi
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt. Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
IndividualB2C- Afzonderlijke verificatie met Azure AD B2C. -
SingleOrg- Organisatieverificatie voor één tenant. Externe id-tenants van Entra gebruiken ook SingleOrg. -
Windows- Windows-verificatie.
-
--aad-b2c-instance <INSTANCE>Het Azure Active Directory B2C-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
IndividualB2Cverificatie. De standaardwaarde ishttps://login.microsoftonline.com/tfp/.-minimal|--use-minimal-apisMaak een project dat gebruikmaakt van de minimale ASP.NET Core-API. De standaardwaarde is
false, maar deze optie wordt overschreven door-controllers. Aangezien de standaardinstelling-controllersisfalse, maakt het invoerendotnet new webapizonder een van de opties op te geven een minimaal API-project.-ssp|--susi-policy-id <ID>De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met
IndividualB2Cverificatie.--aad-instance <INSTANCE>Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde ishttps://login.microsoftonline.com/.--client-id <ID>De client-id voor dit project. Gebruiken met
IndividualB2CofSingleOrgverificatie. De standaardwaarde is11111111-1111-1111-11111111111111111.-controllers|--use-controllersOf u controllers wilt gebruiken in plaats van minimale API's. Als zowel deze optie als
-minimaldeze optie zijn opgegeven, overschrijft deze optie de waarde die is opgegeven door-minimal. Standaard isfalse. Beschikbaar sinds .NET 8 SDK.--domain <DOMAIN>Het domein voor de maptenant. Gebruiken met
IndividualB2CofSingleOrgverificatie. De standaardwaarde isqualified.domain.name.--tenant-id <ID>De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde is22222222-2222-2222-2222-222222222222.-r|--org-read-accessHiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op
SingleOrgverificatie.--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
--no-openapiHiermee wordt ondersteuning voor OpenAPI (Swagger) uitgeschakeld.
AddOpenApienMapOpenApiworden niet gebeld.--no-httpsHiermee schakelt u HTTPS uit. Er wordt geen https-startprofiel gemaakt in
launchSettings.json.app.UseHstsenapp.UseHttpsRedirectionworden niet in Program.cs Startup.cs/ gebeld. Deze optie is alleen van toepassing alsIndividualB2CofSingleOrgniet wordt gebruikt voor verificatie.-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
IndividualB2Cverificatie.-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
apicontroller
API-controller met of zonder lees-/schrijfacties.
-p:n|--name <NAME>De naamruimte voor de gegenereerde code. Standaard is
MyApp.Namespace.-ac|--actionsMaak een controller met lees-/schrijfacties. Standaard is
false.
globaljson
--sdk-version <VERSION_NUMBER>Hiermee geeft u de versie van de .NET SDK te gebruiken in het global.json bestand.
--roll-forward <ROLL_FORWARD_POLICY>Het roll-forward-beleid dat moet worden gebruikt bij het selecteren van een SDK-versie, hetzij als een terugval wanneer een specifieke SDK-versie ontbreekt of als richtlijn voor het gebruik van een latere versie. Zie global-json voor meer informatie.
--test-runner <TEST_RUNNER>Deze optie is geïntroduceerd in .NET 10 SDK en geeft de testrunner op die moet worden gebruikt, VSTest of Microsoft.Testing.Platform. De standaardwaarde is VSTest.
sln
Hiermee maakt u een leeg oplossingsbestand dat geen projecten bevat.
Notitie
In .NET SDK 9.0.200 en hoger ondersteunt deze sjabloon een --format optie om te kiezen tussen sln en slnx indelingen. Vanaf .NET 10 is slnxde standaardindeling .
editorconfig
Hiermee maakt u een .editorconfig-bestand voor het configureren van voorkeuren voor codestijlen.
--emptyHiermee maakt u een lege .editorconfig in plaats van de standaardwaarden voor .NET.
Stopgezette sjablonen
In de volgende tabel ziet u sjablonen die zijn stopgezet en die niet meer vooraf zijn geïnstalleerd met de .NET SDK. Als u sjabloonspecifieke opties wilt zien, selecteert u de korte naamkoppeling.
| Sjablonen | Korte naam | Taal | Tags | Stopgezet sinds |
|---|---|---|---|---|
| ASP.NET Core met hoek | angular |
[C#] | Web/MVC/SPA | 8.0 |
| ASP.NET Core met React.js | react |
[C#] | Web/MVC/SPA | 8.0 |
| Blazor Server-app | blazorserver |
[C#] | Web/Blazor | 8.0 |
| Blazor Server-app leeg | blazorserver-empty |
[C#] | Web/Blazor | 8.0 |
| Blazor WebAssembly App leeg | blazorwasm-empty |
[C#] | Web/Blazor/WebAssembly | 8.0 |
angular, react
Stopgezet sinds .NET 8 SDK.
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt.
Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
Individual- Afzonderlijke verificatie.
-
--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--no-httpsHiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als verificatie is
None.-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
IndividualofIndividualB2Cverificatie.-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
Notitie
Er is echter geen React-sjabloon voor
net8.0als u geïnteresseerd bent in het ontwikkelen van React-apps met ASP.NET Core, raadpleegt u Overview of Single Page Apps (SPA's) in ASP.NET Core.SDK-versie Standaardwaarde 7.0 net7.0Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--kestrelHttpPortPoortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.
--kestrelHttpsPortPoortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter
no-httpswordt gebruikt (maarno-httpswordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
blazorserver
Stopgezet sinds .NET 8 SDK.
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt. Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
Individual- Afzonderlijke verificatie. -
IndividualB2C- Afzonderlijke verificatie met Azure AD B2C. -
SingleOrg- Organisatieverificatie voor één tenant. Externe id-tenants van Entra gebruikenSingleOrgook . -
MultiOrg- Organisatieverificatie voor meerdere tenants. -
Windows- Windows-verificatie.
-
--aad-b2c-instance <INSTANCE>Het Azure Active Directory B2C-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
IndividualB2Cverificatie. De standaardwaarde ishttps://login.microsoftonline.com/tfp/.-ssp|--susi-policy-id <ID>De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met
IndividualB2Cverificatie.-rp|--reset-password-policy-id <ID>De wachtwoordbeleids-id voor dit project opnieuw instellen. Gebruiken met
IndividualB2Cverificatie.-ep|--edit-profile-policy-id <ID>De profielbeleids-id voor dit project bewerken. Gebruiken met
IndividualB2Cverificatie.--aad-instance <INSTANCE>Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgofMultiOrgverificatie. De standaardwaarde ishttps://login.microsoftonline.com/.--client-id <ID>De client-id voor dit project. Gebruiken met
IndividualB2C,SingleOrgofMultiOrgverificatie. De standaardwaarde is11111111-1111-1111-11111111111111111.--domain <DOMAIN>Het domein voor de maptenant. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde isqualified.domain.name.--tenant-id <ID>De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde is22222222-2222-2222-2222-222222222222.--callback-path <PATH>Het aanvraagpad binnen het basispad van de omleidings-URI van de toepassing. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde is/signin-oidc.-r|--org-read-accessHiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op
SingleOrgofMultiOrgverificatie.--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
--no-httpsHiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als
Individual,IndividualB2CofSingleOrgMultiOrgniet wordt gebruikt voor--auth.-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
IndividualofIndividualB2Cverificatie.--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
--kestrelHttpPortPoortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.
--kestrelHttpsPortPoortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter
no-httpswordt gebruikt (maarno-httpswordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.
blazorwasm
-f|--framework <FRAMEWORK>Hiermee geeft u het framework dat moet worden gericht.
De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:
SDK-versie Standaardwaarde 10.0 net10.09.0 net9.08.0 net8.0Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt
--frameworku voorconsoleprojecten eerder in dit artikel.--no-restoreVoert geen impliciete herstelbewerking uit tijdens het maken van het project.
-ho|--hostedBevat een ASP.NET Core-host voor de BlazorWebAssembly app.
-au|--auth <AUTHENTICATION_TYPE>Het type verificatie dat moet worden gebruikt. Mogelijke waarden zijn:
-
None- Geen verificatie (standaard). -
Individual- Afzonderlijke verificatie. -
IndividualB2C- Afzonderlijke verificatie met Azure AD B2C. -
SingleOrg- Organisatieverificatie voor één tenant. Externe id-tenants van Entra gebruiken ook SingleOrg.
-
--authority <AUTHORITY>De instantie van de OIDC-provider. Gebruiken met
Individualverificatie. De standaardwaarde ishttps://login.microsoftonline.com/.--aad-b2c-instance <INSTANCE>Het Azure Active Directory B2C-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
IndividualB2Cverificatie. De standaardwaarde ishttps://aadB2CInstance.b2clogin.com/.-ssp|--susi-policy-id <ID>De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met
IndividualB2Cverificatie.--aad-instance <INSTANCE>Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde ishttps://login.microsoftonline.com/.--client-id <ID>De client-id voor dit project. Gebruiken met
IndividualB2C,SingleOrgofIndividualverificatie in zelfstandige scenario's. De standaardwaarde is33333333-3333-3333-33333333333333333.--domain <DOMAIN>Het domein voor de maptenant. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde isqualified.domain.name.--app-id-uri <URI>De app-id-URI voor de server-API die u wilt aanroepen. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde isapi.id.uri.--api-client-id <ID>De client-id voor de API die door de server wordt gehost. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde is11111111-1111-1111-11111111111111111.-s|--default-scope <SCOPE>Het API-bereik dat de client moet aanvragen om een toegangstoken in te richten. Gebruiken met
SingleOrgofIndividualB2Cverificatie. De standaardwaarde isuser_impersonation.--tenant-id <ID>De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met
SingleOrgverificatie. De standaardwaarde is22222222-2222-2222-2222-222222222222.-r|--org-read-accessHiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op
SingleOrgverificatie.--exclude-launch-settingsSluit launchSettings.json uit van de gegenereerde sjabloon.
-p|--pwaproduceert een Progressive Web Application (PWA) die ondersteuning biedt voor installatie en offlinegebruik.
--no-httpsHiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als
Individual,IndividualB2CofSingleOrgniet wordt gebruikt voor--auth.-uld|--use-local-dbHiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op
IndividualofIndividualB2Cverificatie.--called-api-url <URL>URL van de API die moet worden aangeroepen vanuit de web-app. Alleen van toepassing op
SingleOrgofIndividualB2Cverificatie zonder ASP.NET Core-host opgegeven. De standaardwaarde ishttps://graph.microsoft.com/v1.0/me.--calls-graphHiermee geeft u op of de web-app Microsoft Graph aanroept. Alleen van toepassing op
SingleOrgverificatie.--called-api-scopes <SCOPES>Bereiken om de API aan te roepen vanuit de web-app. Alleen van toepassing op
SingleOrgofIndividualB2Cverificatie zonder ASP.NET Core-host opgegeven. De standaardwaarde isuser.read.--kestrelHttpPortPoortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.
--kestrelHttpsPortPoortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter
no-httpswordt gebruikt (maarno-httpswordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth--use-program-mainIndien opgegeven, worden een expliciete
Programklasse enMainmethode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde:false.