Delen via

.NET-standaardsjablonen voor dotnet nieuw

  • Artikel

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

In de volgende tabel ziet u de sjablonen die vooraf zijn geïnstalleerd met de .NET SDK. De standaardtaal voor de sjabloon wordt weergegeven tussen de vierkante haken. Klik op de korte naamkoppeling om de specifieke sjabloonopties weer te geven.

Sjablonen Korte naam Taal Tags Geïntroduceerd
Console Application console [C#], F#, VB Algemeen/Console 1.0
Klassebibliotheek classlib [C#], F#, VB Algemeen/Bibliotheek 1.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)
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
MSTest-testproject mstest [C#], F#, VB Testen/MSTest 1.0
MSTest-testklasse mstest-class [C#], F#, VB Testen/MSTest 1.0
Testproject NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Testitem NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
xUnit-testproject xunit [C#], F#, VB Test/xUnit 1.0
Razor-onderdeel razorcomponent [C#] Web/ASP.NET 3,0
Razor-pagina page [C#] Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0
Blazor Web-app blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Zelfstandige app blazorwasm [C#] Web/Blazor//WebAssemblyPWA 3.1.300
ASP.NET Core leeg web [C#], F# Web/leeg 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
Razor-klassebibliotheek razorclasslib [C#] Web/Razor/Library/Razor Class Library 2.1
ASP.NET Core Web-API webapi [C#], F# Web/Web-API/API/Service/WebAPI 1.0
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 gRPC-service grpc [C#] Web/gRPC 3,0
dotnet gitignore-bestand gitignore Configureren 3,0
global.json-bestand globaljson Configureren 2.0
NuGet-configuratie nugetconfig Configureren 1.0
Manifestbestand van het lokale hulpprogramma Dotnet tool-manifest Configureren 3,0
Webconfiguratie webconfig Configureren 1.0
Oplossingsbestand sln Oplossing 1.0
Protocolbufferbestand proto Web/gRPC 3,0
EditorConfig-bestand editorconfig Configureren 6,0

In de volgende tabel ziet u sjablonen die zijn stopgezet en die niet meer vooraf zijn geïnstalleerd met de .NET SDK. Klik op de korte naamkoppeling om de specifieke sjabloonopties weer te geven.

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
BlazorWebAssembly App leeg blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Sjabloonopties

Voor elke sjabloon zijn mogelijk extra opties beschikbaar. 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. Als de sjabloon meerdere talen ondersteunt, toont deze opdracht help 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#. De sjablonen die worden verzonden met de .NET SDK hebben de volgende extra opties:

console

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht. Beschikbaar sinds .NET Core 3.0 SDK.

    De volgende tabel bevat de standaardwaarden op basis van de SDK-versie die u gebruikt:

    SDK-versie Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    3.1 netcoreapp3.1

    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 7 SDK hebt geïnstalleerd, is de enige waarde die beschikbaar is net7.0voor--framework. Als u de .NET 6 SDK installeert, wordt de waarde net6.0 beschikbaar voor --framework. Als u de .NET Core 3.1 SDK installeert, netcoreapp3.1 wordt deze beschikbaar, enzovoort. Als u dus opgeeft dat u .NET Core 3.1 kunt opgeven --framework netcoreapp3.1 , zelfs tijdens dotnet new uitvoering in de .NET 6 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 console project wilt maken dat is gericht netcoreapp1.0op , voert u deze uit dotnet new install Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Hiermee stelt u de LangVersion eigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld --langVersion 7.3 C# 7.3. Niet ondersteund voor F#. Beschikbaar sinds .NET Core 2.2 SDK.

    Zie Defaults voor een lijst met standaard C#-versies.

  • --no-restore

    Als dit is opgegeven, wordt er geen impliciete herstelbewerking uitgevoerd tijdens het maken van het project. Beschikbaar sinds .NET Core 2.2 SDK.

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode 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: net8.0, net7.0of net6.0 om een .NET-klassebibliotheek te maken of netstandard2.1 netstandard2.0 om een .NET Standard-klassebibliotheek te maken. De standaardwaarde voor .NET SDK 8.0.x is net8.0.

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --langVersion <VERSION_NUMBER>

    Hiermee stelt u de LangVersion eigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld --langVersion 7.3 C# 7.3. Niet ondersteund voor F#. Beschikbaar sinds .NET Core 2.2 SDK.

    Zie Defaults voor een lijst met standaard C#-versies.

  • --no-restore

    Voert 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 8 SDK is net8.0de standaardwaarde . Beschikbaar sinds .NET Core 3.1 SDK.

  • --langVersion <VERSION_NUMBER>

    Hiermee stelt u de LangVersion eigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld --langVersion 7.3 C# 7.3.

    Zie Defaults voor een lijst met standaard C#-versies.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Hiermee stelt u de LangVersion eigenschap in het gemaakte projectbestand in. Gebruik bijvoorbeeld --langVersion 7.3 C# 7.3.

    Zie Defaults voor een lijst met standaard C#-versies.

  • --no-restore

    Voert 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 8 SDK is net8.0. Beschikbaar sinds .NET Core 3.1 SDK.

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode 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. Optie beschikbaar sinds .NET Core 3.0 SDK.

    De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:

    SDK-versie Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

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 6 SDK hebt geïnstalleerd, is net6.0de enige beschikbare waarde--framework. Als u de .NET 5 SDK installeert, wordt de waarde net5.0 beschikbaar voor --framework. Als u de .NET Core 3.1 SDK installeert, netcoreapp3.1 wordt deze beschikbaar, enzovoort. Als u dus opgeeft dat u .NET Core 3.1 kunt opgeven --framework netcoreapp3.1 , zelfs tijdens dotnet new uitvoering in de .NET 6 SDK.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --sdk

    Gebruik de projectstijl MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    De runner/platform voor het testproject. Mogelijke waarden zijn:

    • VSTest - VSTest-platform (standaard).
    • MSTest - MSTest Runner (bijvoorbeeld 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 MSTest Runner. 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-pack

    Maakt 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. Optie beschikbaar sinds .NET Core 3.0 SDK.

    De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:

    SDK-versie Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

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 6 SDK hebt geïnstalleerd, is net6.0de enige beschikbare waarde--framework. Als u de .NET 5 SDK installeert, wordt de waarde net5.0 beschikbaar voor --framework. Als u de .NET Core 3.1 SDK installeert, netcoreapp3.1 wordt deze beschikbaar, enzovoort. Als u dus opgeeft dat u .NET Core 3.1 kunt opgeven --framework netcoreapp3.1 , zelfs tijdens dotnet new uitvoering in de .NET 6 SDK.

  • -p|--enable-pack

    Maakt het inschakelen van pakketten voor het project met behulp van dotnet pack.

  • --no-restore

    Voert 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 Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

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 6 SDK hebt geïnstalleerd, is net6.0de enige beschikbare waarde--framework. Als u de .NET 5 SDK installeert, wordt de waarde net5.0 beschikbaar voor --framework. Als u de .NET Core 3.1 SDK installeert, netcoreapp3.1 wordt deze beschikbaar, enzovoort. Als u dus opgeeft dat u .NET Core 3.1 kunt opgeven --framework netcoreapp3.1 , zelfs tijdens dotnet new uitvoering in de .NET 6 SDK.

  • -p|--enable-pack

    Maakt het inschakelen van pakketten voor het project met behulp van dotnet pack.

  • --no-restore

    Voert 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-pagemodel

    Hiermee maakt u de pagina zonder PageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Naamruimte voor de gegenereerde code. De standaardwaarde is MyApp.Namespace.

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 gebruiken SingleOrgook .
    • 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 IndividualB2C verificatie. De standaardwaarde is https://login.microsoftonline.com/tfp/.

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

    De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met IndividualB2C verificatie.

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

    De wachtwoordbeleids-id voor dit project opnieuw instellen. Gebruiken met IndividualB2C verificatie.

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

    De profielbeleids-id voor dit project bewerken. Gebruiken met IndividualB2C verificatie.

  • --aad-instance <INSTANCE>

    Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg of MultiOrg verificatie. De standaardwaarde is https://login.microsoftonline.com/.

  • --client-id <ID>

    De client-id voor dit project. Gebruiken met IndividualB2C, SingleOrgof MultiOrg verificatie. De standaardwaarde is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Het domein voor de maptenant. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is qualified.domain.name.

  • --tenant-id <ID>

    De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Het aanvraagpad binnen het basispad van de omleidings-URI van de toepassing. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is /signin-oidc.

  • -r|--org-read-access

    Hiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op SingleOrg of MultiOrg verificatie.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • --no-https

    Hiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als Individual, IndividualB2Cof MultiOrg SingleOrgniet wordt gebruikt voor --auth.

  • -uld|--use-local-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op Individual of IndividualB2C verificatie.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --kestrelHttpPort

    Poortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.

  • --kestrelHttpsPort

    Poortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter no-https wordt gebruikt (maar no-https wordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde: false.

blazor

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht.

    Deze sjabloon is beschikbaar voor .NET 8 of hoger.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --exclude-launch-settings

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

  • --empty

    Laat 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-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op Individual verificatie.

  • -ai|--all-interactive

    Maakt 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|--interactivity optie niet is ingesteld op None.

  • --no-https

    Hiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als Individual niet voor de -au|--auth optie is gekozen.

  • --use-program-main

    Indien opgegeven, wordt een expliciete Program klasse en Main methode gegenereerd in plaats van instructies op het hoogste niveau.

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 Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • -ho|--hosted

    Bevat 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 Individual verificatie. De standaardwaarde is https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Het Azure Active Directory B2C-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met IndividualB2C verificatie. De standaardwaarde is https://aadB2CInstance.b2clogin.com/.

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

    De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met IndividualB2C verificatie.

  • --aad-instance <INSTANCE>

    Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is https://login.microsoftonline.com/.

  • --client-id <ID>

    De client-id voor dit project. Gebruiken met IndividualB2C, SingleOrgof Individual verificatie in zelfstandige scenario's. De standaardwaarde is 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Het domein voor de maptenant. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is qualified.domain.name.

  • --app-id-uri <URI>

    De app-id-URI voor de server-API die u wilt aanroepen. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is api.id.uri.

  • --api-client-id <ID>

    De client-id voor de API die door de server wordt gehost. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is 11111111-1111-1111-11111111111111111.

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

    Het API-bereik dat de client moet aanvragen om een toegangstoken in te richten. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is user_impersonation.

  • --tenant-id <ID>

    De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Hiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op SingleOrg verificatie.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • -p|--pwa

    produceert een Progressive Web Application (PWA) die ondersteuning biedt voor installatie en offlinegebruik.

  • --no-https

    Hiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als Individual, IndividualB2Cof SingleOrg niet wordt gebruikt voor --auth.

  • -uld|--use-local-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op Individual of IndividualB2C verificatie.

  • --called-api-url <URL>

    URL van de API die moet worden aangeroepen vanuit de web-app. Alleen van toepassing op SingleOrg of IndividualB2C verificatie zonder ASP.NET Core-host opgegeven. De standaardwaarde is https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Hiermee geeft u op of de web-app Microsoft Graph aanroept. Alleen van toepassing op SingleOrg verificatie.

  • --called-api-scopes <SCOPES>

    Bereiken om de API aan te roepen vanuit de web-app. Alleen van toepassing op SingleOrg of IndividualB2C verificatie zonder ASP.NET Core-host opgegeven. De standaardwaarde is user.read.

  • --kestrelHttpPort

    Poortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.

  • --kestrelHttpsPort

    Poortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter no-https wordt gebruikt (maar no-https wordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde: false.

web

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht. Optie niet beschikbaar in .NET Core 2.2 SDK.

    De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:

    SDK-versie Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0
    2.1 netcoreapp2.1

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --no-https

    Hiermee schakelt u HTTPS uit.

  • --kestrelHttpPort

    Poortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.

  • --kestrelHttpsPort

    Poortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter no-https wordt gebruikt (maar no-https wordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode 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 IndividualB2C verificatie. De standaardwaarde is https://login.microsoftonline.com/tfp/.

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

    De aanmeldings- en registratiebeleids-id voor dit project. Gebruiken met IndividualB2C verificatie.

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

    De wachtwoordbeleids-id voor dit project opnieuw instellen. Gebruiken met IndividualB2C verificatie.

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

    De profielbeleids-id voor dit project bewerken. Gebruiken met IndividualB2C verificatie.

  • --aad-instance <INSTANCE>

    Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg of MultiOrg verificatie. De standaardwaarde is https://login.microsoftonline.com/.

  • --client-id <ID>

    De client-id voor dit project. Gebruiken met IndividualB2C, SingleOrgof MultiOrg verificatie. De standaardwaarde is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Het domein voor de maptenant. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is qualified.domain.name.

  • --tenant-id <ID>

    De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Het aanvraagpad binnen het basispad van de omleidings-URI van de toepassing. Gebruiken met SingleOrg of IndividualB2C verificatie. De standaardwaarde is /signin-oidc.

  • -r|--org-read-access

    Hiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op SingleOrg of MultiOrg verificatie.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • --no-https

    Hiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing alsIndividual, IndividualB2CSingleOrgof MultiOrg niet wordt gebruikt.

  • -uld|--use-local-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op Individual of IndividualB2C verificatie.

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht. Optie beschikbaar sinds .NET Core 3.0 SDK.

    De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:

    SDK-versie Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --use-browserlink

    Bevat BrowserLink in het project. Optie niet beschikbaar in .NET Core 2.2 en 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Bepaalt of het project is geconfigureerd voor het gebruik van Razor Runtime-compilatie in builds voor foutopsporing. Optie beschikbaar sinds .NET Core 3.1.201 SDK.

  • --kestrelHttpPort

    Poortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.

  • --kestrelHttpsPort

    Poortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter no-https wordt gebruikt (maar no-https wordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde: false.

angular, react

Stopgezet sinds .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Het type verificatie dat moet worden gebruikt. Beschikbaar sinds .NET Core 3.0 SDK.

    Mogelijke waarden zijn:

    • None - Geen verificatie (standaard).
    • Individual - Afzonderlijke verificatie.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --no-https

    Hiermee schakelt u HTTPS uit. Deze optie is alleen van toepassing als verificatie is None.

  • -uld|--use-local-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op Individual of IndividualB2C verificatie. Beschikbaar sinds .NET Core 3.0 SDK.

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht. Optie niet beschikbaar in .NET Core 2.2 SDK.

    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 Default value
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0
    2.1 netcoreapp2.0

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --kestrelHttpPort

    Poortnummer dat moet worden gebruikt voor het HTTP-eindpunt in launchSettings.json.

  • --kestrelHttpsPort

    Poortnummer dat moet worden gebruikt voor het HTTPS-eindpunt in launchSettings.json. Deze optie is niet van toepassing wanneer de parameter no-https wordt gebruikt (maar no-https wordt genegeerd wanneer een instelling voor afzonderlijke of organisatieverificatie is gekozen).--auth

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode gebruikt in plaats van instructies op het hoogste niveau. Beschikbaar sinds .NET SDK 6.0.300. Standaardwaarde: false.

razorclasslib

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

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

    Ondersteunt het toevoegen van traditionele Razor-pagina's en weergaven naast onderdelen aan deze bibliotheek. Beschikbaar sinds .NET Core 3.0 SDK.

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-settings

    Sluit 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 Default value
    8.0 net8.0

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode 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 IndividualB2C verificatie. De standaardwaarde is https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Maak 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 -controllers is false, maakt het invoeren dotnet new webapi zonder 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 IndividualB2C verificatie.

  • --aad-instance <INSTANCE>

    Het Azure Active Directory-exemplaar waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is https://login.microsoftonline.com/.

  • --client-id <ID>

    De client-id voor dit project. Gebruiken met IndividualB2C of SingleOrg verificatie. De standaardwaarde is 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Of u controllers wilt gebruiken in plaats van minimale API's. Als zowel deze optie als -minimal deze optie zijn opgegeven, overschrijft deze optie de waarde die is opgegeven door -minimal. Standaard is false. Beschikbaar sinds .NET 8 SDK.

  • --domain <DOMAIN>

    Het domein voor de maptenant. Gebruiken met IndividualB2C of SingleOrg verificatie. De standaardwaarde is qualified.domain.name.

  • --tenant-id <ID>

    De TenantId-id van de map waarmee verbinding moet worden gemaakt. Gebruiken met SingleOrg verificatie. De standaardwaarde is 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Hiermee heeft deze toepassing leestoegang tot de map. Alleen van toepassing op SingleOrg verificatie.

  • --exclude-launch-settings

    Sluit launchSettings.json uit van de gegenereerde sjabloon.

  • --no-openapi

    Hiermee wordt ondersteuning voor OpenAPI (Swagger) uitgeschakeld. AddSwaggerGen, UseSwaggeren UseSwaggerUI worden niet gebeld.

  • --no-https

    Hiermee schakelt u HTTPS uit. Er wordt geen https-startprofiel gemaakt in launchSettings.json. app.UseHstsen app.UseHttpsRedirection worden niet in Program.cs Startup.cs/ gebeld. Deze optie is alleen van toepassing als IndividualB2C of SingleOrg niet wordt gebruikt voor verificatie.

  • -uld|--use-local-db

    Hiermee geeft u LocalDB moet worden gebruikt in plaats van SQLite. Alleen van toepassing op IndividualB2C verificatie.

  • -f|--framework <FRAMEWORK>

    Hiermee geeft u het framework dat moet worden gericht. Optie niet beschikbaar in .NET Core 2.2 SDK.

    De volgende tabel bevat de standaardwaarden op basis van het SDK-versienummer dat u gebruikt:

    SDK-versie Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0
    2.1 netcoreapp2.1

    Als u een project wilt maken dat is gericht op een framework dat eerder is dan de SDK die u gebruikt, raadpleegt --framework u voor console projecten eerder in dit artikel.

  • --no-restore

    Voert geen impliciete herstelbewerking uit tijdens het maken van het project.

  • --use-program-main

    Indien opgegeven, worden een expliciete Program klasse en Main methode 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|--actions

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

editorconfig

Hiermee maakt u een .editorconfig-bestand voor het configureren van voorkeuren voor codestijlen.

  • --empty

    Hiermee maakt u een lege .editorconfig in plaats van de standaardwaarden voor .NET.

Zie ook