Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Standardmallar för
När du installerar .NET SDK får du över ett dussin inbyggda mallar för att skapa projekt och filer, inklusive konsolappar, klassbibliotek, enhetstestprojekt, ASP.NET Core-appar (inklusive Angular - och React-projekt ) och konfigurationsfiler. Kör kommandot för dotnet new list att lista de inbyggda mallarna:
dotnet new list
Mallalternativ
Mallarna som levereras med .NET SDK har mallspecifika alternativ. Om du vill visa de ytterligare alternativ som är tillgängliga för mallen --help använder du alternativet med argumentet mallnamn, till exempel: dotnet new console --help. De mallspecifika avsnitten i den här artikeln beskriver också alternativen.
Om mallen stöder flera programmeringsspråk --help visar alternativet hjälp för mallen på standardspråket. Genom att kombinera det med --language alternativet kan du se hjälpen för andra språk: dotnet new console --help --language F#.
Förinstallerade mallar
I följande tabell visas de mallar som är förinstallerade med .NET SDK. Standardspråket för mallen visas inom hakparenteser. Om du vill se några mallspecifika alternativ väljer du den korta namnlänken.
| Mallar | Kort namn | Språk | Taggar | Introducerade |
|---|---|---|---|---|
| ASP.NET Core API | webapiaot |
[C#] | Webb-/webb-API/API/tjänst | 8.0 |
| ASP.NET Core API-styrenhet | apicontroller |
[C#] | Webb/ASP.NET | 8.0 |
| ASP.NET Core Tom | web |
[C#], F# | Webb/tom | 1.0 |
| ASP.NET Core Web API | webapi |
[C#], F# | Webb-/webb-API/API/Tjänst/WebAPI | 1.0 |
| ASP.NET Core Web App (modell–View-Controller) | mvc |
[C#], F# | Webb/MVC | 1.0 |
| ASP.NET Core Web App | webapp, razor |
[C#] | Webb-/MVC-/Razor-sidor | 2.2, 2.0 |
| ASP.NET Core gRPC-tjänsten | grpc |
[C#] | Webb/gRPC | 3,0 |
| Blazor Webbapp | blazor |
[C#] | Webb/Blazor | 8.0.100 |
| Blazor WebAssembly Fristående app | blazorwasm |
[C#] | Webb/Blazor/WebAssembly/PWA | 3.1.300 |
| Klassbibliotek | classlib |
[C#], F#, VB | Common/Library | 1.0 |
| Konsolprogram | console |
[C#], F#, VB | Common/Console | 1.0 |
| Directory.Build.props-fil | buildprops |
Konfigurera | 8.0.100 | |
| Directory.Build.targets-fil | buildtargets |
Konfigurera | 8.0.100 | |
| Dotnet-manifestfil för lokalt verktyg | tool-manifest |
Konfigurera | 3,0 | |
| EditorConfig-fil | editorconfig |
Konfigurera | 6,0 | |
| global.json fil | globaljson |
Konfigurera | 2.0 | |
| MSTest-testklass | mstest-class |
[C#], F#, VB | Test/MSTest | 1.0 |
| MSTest-testprojekt | mstest |
[C#], F#, VB | Test/MSTest | 1.0 |
| NUnit 3-testobjekt | nunit-test |
[C#], F#, VB | Test/NUnit | 2,2 |
| NUnit 3-testprojekt | nunit |
[C#], F#, VB | Test/NUnit | 2.1.400 |
| NuGet-konfiguration | nugetconfig |
Konfigurera | 1.0 | |
| Protokollbuffertfil | proto |
Webb/gRPC | 3,0 | |
| Razor-klassbibliotek | razorclasslib |
[C#] | Webb/Razor/Bibliotek/Razor-klassbibliotek | 2.1 |
| Razor-komponent | razorcomponent |
[C#] | Webb/ASP.NET | 3,0 |
| Razor-sida | page |
[C#] | Webb/ASP.NET | 2.0 |
| Lösningsfil | sln |
Lösning | 1.0 | |
| Webbkonfiguration | webconfig |
Konfigurera | 1.0 | |
| Windows Forms-program (WinForms) | winforms |
[C#], VB | Common/WinForms | 3.0 (5.0 för VB) |
| Windows Forms-klassbibliotek (WinForms) | winformslib |
[C#], VB | Common/WinForms | 3.0 (5.0 för VB) |
| Arbetstjänst | worker |
[C#] | Common/Worker/Web | 3,0 |
| WPF-program | wpf |
[C#], VB | Common/WPF | 3.0 (5.0 för VB) |
| WPF-klassbibliotek | wpflib |
[C#], VB | Common/WPF | 3.0 (5.0 för VB) |
| ANPASSAT WPF-kontrollbibliotek | wpfcustomcontrollib |
[C#], VB | Common/WPF | 3.0 (5.0 för VB) |
| WPF-användarkontrollbibliotek | wpfusercontrollib |
[C#], VB | Common/WPF | 3.0 (5.0 för VB) |
| xUnit-testprojekt | xunit |
[C#], F#, VB | Test/xUnit | 1.0 |
| MVC-vyImporter | viewimports |
[C#] | Webb/ASP.NET | 2.0 |
| MVC ViewStart | viewstart |
[C#] | Webb/ASP.NET | 2.0 |
buildprops
Skapar en Directory.Build.props-fil för att anpassa MSBuild-egenskaper för ett helt mappträd. Mer information finns i Anpassa din version.
--inheritOm det anges lägger du till ett importelement för den närmaste Directory.Build.props-filen i den överordnade kataloghierarkin. Som standard ärver inte Directory.Build.props-filer från överordnade kataloger, så om du aktiverar det här alternativet kan du skapa en hierarki med anpassningar mapp för mapp.
--use-artifactsOm det anges lägger du till en egenskap för att aktivera utdatalayouten för artefakter. Det här är ett vanligt mönster för projekt som skapar byggartefakter, till exempel NuGet-paket, som placeras i en gemensam mappstruktur. Mer information finns i Artefaktutdatalayout.
buildtargets
Skapar en Directory.Build.targets-fil för att anpassa MSBuild-mål och uppgifter för ett helt mappträd. Mer information finns i Anpassa din version.
--inheritOm det anges lägger du till ett importelement för den närmaste filen Directory.Build.targets i den överordnade kataloghierarkin. Som standard ärver inte Directory.Build.targets-filer från överordnade kataloger, så om du aktiverar det här alternativet kan du skapa en hierarki med anpassningar mapp för mapp.
console
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt den SDK-version som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0Möjligheten att skapa ett projekt för en tidigare TFM beror på att den versionen av SDK:t är installerad. Om du till exempel bara har installerat .NET 9 SDK är det enda tillgängliga värdet för
--frameworknet9.0. Om du till exempel installerar .NET 8 SDK blir värdetnet8.0tillgängligt för--framework. Så genom att ange--framework net8.0kan du rikta in dig på .NET 8 även när du kördotnet newi .NET 9 SDK.Om du vill skapa ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder kanske du kan göra det genom att installera NuGet-paketet för mallen. Vanliga projekttyper, webb- och SPA-projekt använder olika paket per målramverksmoniker (TFM). Om du till exempel vill skapa ett
consoleprojekt som riktar sig motnetcoreapp1.0kör dudotnet new installpåMicrosoft.DotNet.Common.ProjectTemplates.1.x.--langVersion <VERSION_NUMBER>Anger egenskapen
LangVersioni den skapade projektfilen. Använd till exempel--langVersion 7.3för att använda C# 7.3. Stöds inte för F#.En lista över C#-standardversioner finns i Standardinställningar.
--no-restoreOm det anges kör du inte en implicit återställning när projektet skapas.
--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false. Endast tillgängligt för C#.
classlib
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas. Värden:
net9.0,net8.0, ellernet7.0för att skapa ett .NET-klassbibliotek ellernetstandard2.1netstandard2.0för att skapa ett .NET Standard-klassbibliotek. Standardvärdet för .NET SDK 9.0.x ärnet9.0.Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--langVersion <VERSION_NUMBER>Anger egenskapen
LangVersioni den skapade projektfilen. Använd till exempel--langVersion 7.3för att använda C# 7.3. Stöds inte för F#.En lista över C#-standardversioner finns i Standardinställningar.
--no-restoreKör inte en implicit återställning när projektet skapas.
wpf, wpflib, , wpfcustomcontrollibwpfusercontrollib
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas. För .NET 9 SDK är standardvärdet
net9.0.--langVersion <VERSION_NUMBER>Anger egenskapen
LangVersioni den skapade projektfilen. Använd till exempel--langVersion 7.3för att använda C# 7.3.En lista över C#-standardversioner finns i Standardinställningar.
--no-restoreKör inte en implicit återställning när projektet skapas.
winforms, winformslib
--langVersion <VERSION_NUMBER>Anger egenskapen
LangVersioni den skapade projektfilen. Använd till exempel--langVersion 7.3för att använda C# 7.3.En lista över C#-standardversioner finns i Standardinställningar.
--no-restoreKör inte en implicit återställning när projektet skapas.
worker, grpc
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas. Standardvärdet för .NET 9 SDK är
net9.0.Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
--no-restoreKör inte en implicit återställning när projektet skapas.
--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
mstest
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0
Möjligheten att skapa ett projekt för en tidigare TFM beror på att den versionen av SDK:t är installerad. Om du till exempel bara har installerat .NET 9 SDK är det enda tillgängliga värdet för --frameworknet9.0. Om du till exempel installerar .NET 8 SDK blir värdet net8.0 tillgängligt för --framework. Så genom att ange --framework net8.0 kan du rikta in dig på .NET 8 även när du kör dotnet new i .NET 9 SDK.
--no-restoreKör inte en implicit återställning när projektet skapas.
--sdkAnvänd MSTest.Sdk-projektformat.
--test-runner <TEST_RUNNER>Löparen/plattformen för testprojektet. Möjliga värden är:
-
VSTest– VSTest-plattform (standard). -
MSTest– Microsoft.Testing.Platform.
-
--coverage-tool <COVERAGE_TOOL>Täckningsverktyget som ska användas för testprojektet. Möjliga värden är:
-
Microsoft.CodeCoverage– Microsoft Code Coverage (standard). -
coverlet- coverlet täckningsverktyg.
-
--extensions-profile <EXTENSIONS_PROFILE>Profilen för SDK-tillägg när du använder Microsoft.Testing.Platform. Möjliga värden är:
-
Default– Standardtilläggsprofil (standard). -
None– Inga tillägg är aktiverade. -
AllMicrosoft– Aktivera alla tillägg som levereras av Microsoft (inklusive tillägg med en begränsande licens).
-
--fixture <FIXTURE>De typer av armaturer som ska ingå i testprojektet. Möjliga värden är:
-
None- Inga fixturmetoder. -
AssemblyInitialize- AssemblyInitialize fixture method. -
AssemblyCleanup- AssemblyCleanup fixture metod. -
ClassInitialize- ClassInitialize fixture-metod. -
ClassCleanup- ClassCleanup-fixturmetod. -
TestInitialize- TestInitialisera fixturmetod. -
TestCleanup- TestCleanup fixture metod.
Där flera värden tillåts.
-
-p|--enable-packAktiverar paketering för projektet med hjälp av dotnet-paketet.
mstest-class
--fixture <FIXTURE>De typer av armaturer som ska ingå i testprojektet. Möjliga värden är:
-
None- Inga fixturmetoder. -
AssemblyInitialize- AssemblyInitialize fixture method. -
AssemblyCleanup- AssemblyCleanup fixture metod. -
ClassInitialize- ClassInitialize fixture-metod. -
ClassCleanup- ClassCleanup-fixturmetod. -
TestInitialize- TestInitialisera fixturmetod. -
TestCleanup- TestCleanup fixture metod.
Där flera värden tillåts.
-
xunit
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0
Möjligheten att skapa ett projekt för en tidigare TFM beror på att den versionen av SDK:t är installerad. Om du till exempel bara har installerat .NET 9 SDK är det enda tillgängliga värdet för --frameworknet9.0. Om du till exempel installerar .NET 8 SDK blir värdet net8.0 tillgängligt för --framework. Så genom att ange --framework net8.0 kan du rikta in dig på .NET 8 även när du kör dotnet new i .NET 9 SDK.
-p|--enable-packAktiverar paketering för projektet med hjälp av dotnet-paketet.
--no-restoreKör inte en implicit återställning när projektet skapas.
nunit
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0
Möjligheten att skapa ett projekt för en tidigare TFM beror på att den versionen av SDK:t är installerad. Om du till exempel bara har installerat .NET 9 SDK är det enda tillgängliga värdet för --frameworknet9.0. Om du till exempel installerar .NET 8 SDK blir värdet net8.0 tillgängligt för --framework. Så genom att ange --framework net8.0 kan du rikta in dig på .NET 8 även när du kör dotnet new i .NET 9 SDK.
-p|--enable-packAktiverar paketering för projektet med hjälp av dotnet-paketet.
--no-restoreKör inte en implicit återställning när projektet skapas.
page
-na|--namespace <NAMESPACE_NAME>Namnområde för den genererade koden. Standardvärdet är
MyApp.Namespace.-np|--no-pagemodelSkapar sidan utan en PageModel.
viewimports, proto
-na|--namespace <NAMESPACE_NAME>Namnområde för den genererade koden. Standardvärdet är
MyApp.Namespace.
blazor
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
Den här mallen är tillgänglig för .NET 8 eller senare.
--no-restoreKör inte en implicit återställning när projektet skapas.
--exclude-launch-settingsExkluderar launchSettings.json från den genererade appen.
-int|--interactivity <None|Server|Webassembly|Auto >Anger vilket interaktivt återgivningsläge som ska användas för interaktiva komponenter. Möjliga värden är:
-
None– Ingen interaktivitet (endast statisk återgivning på serversidan). -
Server– (Standard) Kör appen på servern med interaktiv återgivning på serversidan. -
WebAssembly– Kör appen med återgivning på klientsidan i webbläsaren med WebAssembly. -
Auto– Använder interaktiv återgivning på serversidan när du laddar ned Blazor paketet och aktiverar körningen Blazor på klienten och använder sedan återgivning på klientsidan med WebAssembly.
-
--emptyUtelämnar exempelsidor och formatering som visar grundläggande användningsmönster.
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas. Möjliga värden är:
-
None– Ingen autentisering (standard). -
Individual– Individuell autentisering.
-
-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
Individualautentisering.-ai|--all-interactiveGör varje sida interaktiv genom att använda ett interaktivt återgivningsläge på den översta nivån. Om
falseanvänder sidor statisk återgivning på serversidan som standard och kan markeras interaktivt per sida eller per komponent. Det här alternativet gäller bara om-i|--interactivityalternativet inte är inställt påNone.--no-httpsInaktiverar HTTPS. Det här alternativet gäller endast om
Individualinte har valts för alternativet-au|--auth.--use-program-mainOm det anges genereras en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner.
web
--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--no-restoreKör inte en implicit återställning när projektet skapas.
--no-httpsInaktiverar HTTPS.
--kestrelHttpPortPortnummer som ska användas för HTTP-slutpunkten i launchSettings.json.
--kestrelHttpsPortPortnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern
no-httpsanvänds (menno-httpsignoreras när en inställning för individuell eller organisatorisk autentisering väljs för--auth).--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
mvc, webapp
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas. Möjliga värden är:
-
None– Ingen autentisering (standard). -
Individual– Individuell autentisering. -
IndividualB2C– Individuell autentisering med Azure AD B2C. -
SingleOrg– Organisationsautentisering för en enskild klientorganisation. Externa Entra-ID-klienter använder också SingleOrg. -
MultiOrg– Organisationsautentisering för flera klienter. -
Windows– Windows-autentisering.
-
--aad-b2c-instance <INSTANCE>Azure Active Directory B2C-instansen att ansluta till. Använd med
IndividualB2Cautentisering. Standardvärdet ärhttps://login.microsoftonline.com/tfp/.-ssp|--susi-policy-id <ID>Princip-ID för inloggning och registrering för det här projektet. Använd med
IndividualB2Cautentisering.-rp|--reset-password-policy-id <ID>Princip-ID för återställning av lösenord för det här projektet. Använd med
IndividualB2Cautentisering.-ep|--edit-profile-policy-id <ID>Redigera profilprincip-ID för det här projektet. Använd med
IndividualB2Cautentisering.--aad-instance <INSTANCE>Azure Active Directory-instansen att ansluta till. Använd med
SingleOrgellerMultiOrgautentisering. Standardvärdet ärhttps://login.microsoftonline.com/.--client-id <ID>Klient-ID för det här projektet. Använd med
IndividualB2C,SingleOrgellerMultiOrgautentisering. Standardvärdet är11111111-1111-1111-11111111111111111.--domain <DOMAIN>Domänen för katalogklientorganisationen. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet ärqualified.domain.name.--tenant-id <ID>TenantId-ID:t för katalogen som ska anslutas till. Använd med
SingleOrgautentisering. Standardvärdet är22222222-2222-2222-2222-222222222222.--callback-path <PATH>Begärandesökvägen i programmets bassökväg för omdirigerings-URI:n. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet är/signin-oidc.-r|--org-read-accessTillåter det här programmet läsåtkomst till katalogen. Gäller endast för
SingleOrgellerMultiOrgautentisering.--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
--no-httpsInaktiverar HTTPS. Det här alternativet gäller endast om
Individual,IndividualB2C,SingleOrgellerMultiOrginte används.-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
IndividualellerIndividualB2Cautentisering.-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--no-restoreKör inte en implicit återställning när projektet skapas.
--use-browserlinkInnehåller BrowserLink i projektet.
-rrc|--razor-runtime-compilationAvgör om projektet är konfigurerat för att använda Razor-körningskompilering i felsökningsversioner.
--kestrelHttpPortPortnummer som ska användas för HTTP-slutpunkten i launchSettings.json.
--kestrelHttpsPortPortnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern
no-httpsanvänds (menno-httpsignoreras när en inställning för individuell eller organisatorisk autentisering väljs för--auth).--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
razorclasslib
--no-restoreKör inte en implicit återställning när projektet skapas.
-s|--support-pages-and-viewsHar stöd för att lägga till traditionella Razor-sidor och vyer utöver komponenter i det här biblioteket.
webapiaot
Skapar ett webb-API-projekt med AOT-publicering aktiverat. Mer information finns i Intern AOT-distribution och Mallen Webb-API (intern AOT).
--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.0--no-restoreKör inte en implicit återställning när projektet skapas.
--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
webapi
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas. Möjliga värden är:
-
None– Ingen autentisering (standard). -
IndividualB2C– Individuell autentisering med Azure AD B2C. -
SingleOrg– Organisationsautentisering för en enskild klientorganisation. Externa Entra-ID-klienter använder också SingleOrg. -
Windows– Windows-autentisering.
-
--aad-b2c-instance <INSTANCE>Azure Active Directory B2C-instansen att ansluta till. Använd med
IndividualB2Cautentisering. Standardvärdet ärhttps://login.microsoftonline.com/tfp/.-minimal|--use-minimal-apisSkapa ett projekt som använder det minimala API:et ASP.NET Core. Standardvärdet är
false, men det här alternativet åsidosättas av-controllers. Eftersom standardvärdet för-controllersär skaparfalseinmatningdotnet new webapiutan att ange något av alternativen ett minimalt API-projekt.-ssp|--susi-policy-id <ID>Princip-ID för inloggning och registrering för det här projektet. Använd med
IndividualB2Cautentisering.--aad-instance <INSTANCE>Azure Active Directory-instansen att ansluta till. Använd med
SingleOrgautentisering. Standardvärdet ärhttps://login.microsoftonline.com/.--client-id <ID>Klient-ID för det här projektet. Använd med
IndividualB2CellerSingleOrgautentisering. Standardvärdet är11111111-1111-1111-11111111111111111.-controllers|--use-controllersOm du vill använda kontrollanter i stället för minimala API:er. Om både det här alternativet och
-minimalanges åsidosätter det här alternativet det värde som anges av-minimal. Standard ärfalse. Tillgänglig sedan .NET 8 SDK.--domain <DOMAIN>Domänen för katalogklientorganisationen. Använd med
IndividualB2CellerSingleOrgautentisering. Standardvärdet ärqualified.domain.name.--tenant-id <ID>TenantId-ID:t för katalogen som ska anslutas till. Använd med
SingleOrgautentisering. Standardvärdet är22222222-2222-2222-2222-222222222222.-r|--org-read-accessTillåter det här programmet läsåtkomst till katalogen. Gäller endast för
SingleOrgautentisering.--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
--no-openapiInaktiverar Stöd för OpenAPI (Swagger).
AddOpenApiochMapOpenApianropas inte.--no-httpsInaktiverar HTTPS. Ingen https-startprofil skapas i
launchSettings.json.app.UseHstsochapp.UseHttpsRedirectionanropas inte i Program.cs/Startup.cs. Det här alternativet gäller endast omIndividualB2CellerSingleOrginte används för autentisering.-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
IndividualB2Cautentisering.-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--no-restoreKör inte en implicit återställning när projektet skapas.
--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
apicontroller
API-styrenhet med eller utan läs-/skrivåtgärder.
-p:n|--name <NAME>Namnområdet för den genererade koden. Standard är
MyApp.Namespace.-ac|--actionsSkapa en kontrollant med läs-/skrivåtgärder. Standard är
false.
globaljson
--sdk-version <VERSION_NUMBER>Anger vilken version av .NET SDK som ska användas i filen global.json .
--roll-forward <ROLL_FORWARD_POLICY>Den roll-forward-princip som ska användas när du väljer en SDK-version, antingen som reserv när en specifik SDK-version saknas eller som ett direktiv för att använda en senare version. Mer information finns i global-json.
--test-runner <TEST_RUNNER>Det här alternativet introducerades i .NET 10 SDK och anger vilken testlöpare som ska användas, antingen VSTest eller Microsoft.Testing.Platform. Standardvärdet är VSTest.
sln
Skapar en tom lösningsfil som inte innehåller några projekt.
Kommentar
I .NET SDK 9.0.200 och senare stöder den här mallen ett --format alternativ för att välja mellan sln och slnx format. Från och med .NET 10 är slnxstandardformatet .
editorconfig
Skapar en .editorconfig-fil för att konfigurera inställningar för kodformat.
--emptySkapar en tom .editorconfig i stället för standardinställningarna för .NET.
Utgångna mallar
I följande tabell visas mallar som har upphört och som inte längre är förinstallerade med .NET SDK. Om du vill se några mallspecifika alternativ väljer du den korta namnlänken.
| Mallar | Kort namn | Språk | Taggar | Har upphört sedan |
|---|---|---|---|---|
| ASP.NET Core med Angular | angular |
[C#] | Webb/MVC/SPA | 8.0 |
| ASP.NET Core med React.js | react |
[C#] | Webb/MVC/SPA | 8.0 |
| Blazor Serverapp | blazorserver |
[C#] | Webb/Blazor | 8.0 |
| Blazor Serverappen är tom | blazorserver-empty |
[C#] | Webb/Blazor | 8.0 |
| Blazor WebAssembly Appen är tom | blazorwasm-empty |
[C#] | Webb/Blazor/WebAssembly | 8.0 |
angular, react
Har upphört sedan .NET 8 SDK.
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas.
Möjliga värden är:
-
None– Ingen autentisering (standard). -
Individual– Individuell autentisering.
-
--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
--no-restoreKör inte en implicit återställning när projektet skapas.
--no-httpsInaktiverar HTTPS. Det här alternativet gäller endast om autentisering är
None.-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
IndividualellerIndividualB2Cautentisering.-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
Kommentar
Det finns ingen React-mall för
net8.0, men om du är intresserad av att utveckla React-appar med ASP.NET Core kan du läsa Översikt över ensidesappar (SPA) i ASP.NET Core.SDK-version Standardvärde 7.0 net7.0Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--kestrelHttpPortPortnummer som ska användas för HTTP-slutpunkten i launchSettings.json.
--kestrelHttpsPortPortnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern
no-httpsanvänds (menno-httpsignoreras när en inställning för individuell eller organisatorisk autentisering väljs för--auth).--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
blazorserver
Har upphört sedan .NET 8 SDK.
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas. Möjliga värden är:
-
None– Ingen autentisering (standard). -
Individual– Individuell autentisering. -
IndividualB2C– Individuell autentisering med Azure AD B2C. -
SingleOrg– Organisationsautentisering för en enskild klientorganisation. Externa ID-klientorganisationer i Entra använderSingleOrgockså . -
MultiOrg– Organisationsautentisering för flera klienter. -
Windows– Windows-autentisering.
-
--aad-b2c-instance <INSTANCE>Azure Active Directory B2C-instansen att ansluta till. Använd med
IndividualB2Cautentisering. Standardvärdet ärhttps://login.microsoftonline.com/tfp/.-ssp|--susi-policy-id <ID>Princip-ID för inloggning och registrering för det här projektet. Använd med
IndividualB2Cautentisering.-rp|--reset-password-policy-id <ID>Princip-ID för återställning av lösenord för det här projektet. Använd med
IndividualB2Cautentisering.-ep|--edit-profile-policy-id <ID>Redigera profilprincip-ID för det här projektet. Använd med
IndividualB2Cautentisering.--aad-instance <INSTANCE>Azure Active Directory-instansen att ansluta till. Använd med
SingleOrgellerMultiOrgautentisering. Standardvärdet ärhttps://login.microsoftonline.com/.--client-id <ID>Klient-ID för det här projektet. Använd med
IndividualB2C,SingleOrgellerMultiOrgautentisering. Standardvärdet är11111111-1111-1111-11111111111111111.--domain <DOMAIN>Domänen för katalogklientorganisationen. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet ärqualified.domain.name.--tenant-id <ID>TenantId-ID:t för katalogen som ska anslutas till. Använd med
SingleOrgautentisering. Standardvärdet är22222222-2222-2222-2222-222222222222.--callback-path <PATH>Begärandesökvägen i programmets bassökväg för omdirigerings-URI:n. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet är/signin-oidc.-r|--org-read-accessTillåter det här programmet läsåtkomst till katalogen. Gäller endast för
SingleOrgellerMultiOrgautentisering.--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
--no-httpsInaktiverar HTTPS. Det här alternativet gäller endast om
Individual,IndividualB2C,SingleOrgellerMultiOrginte används för--auth.-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
IndividualellerIndividualB2Cautentisering.--no-restoreKör inte en implicit återställning när projektet skapas.
--kestrelHttpPortPortnummer som ska användas för HTTP-slutpunkten i launchSettings.json.
--kestrelHttpsPortPortnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern
no-httpsanvänds (menno-httpsignoreras när en inställning för individuell eller organisatorisk autentisering väljs för--auth).--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.
blazorwasm
-f|--framework <FRAMEWORK>Anger det ramverk som ska riktas.
I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:
SDK-version Standardvärde 9.0 net9.08.0 net8.07.0 net7.0Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder
--frameworkfinns i förconsoleprojekt tidigare i den här artikeln.--no-restoreKör inte en implicit återställning när projektet skapas.
-ho|--hostedInnehåller en ASP.NET Core-värd för BlazorWebAssembly appen.
-au|--auth <AUTHENTICATION_TYPE>Den typ av autentisering som ska användas. Möjliga värden är:
-
None– Ingen autentisering (standard). -
Individual– Individuell autentisering. -
IndividualB2C– Individuell autentisering med Azure AD B2C. -
SingleOrg– Organisationsautentisering för en enskild klientorganisation. Externa Entra-ID-klienter använder också SingleOrg.
-
--authority <AUTHORITY>Utfärdaren av OIDC-providern. Använd med
Individualautentisering. Standardvärdet ärhttps://login.microsoftonline.com/.--aad-b2c-instance <INSTANCE>Azure Active Directory B2C-instansen att ansluta till. Använd med
IndividualB2Cautentisering. Standardvärdet ärhttps://aadB2CInstance.b2clogin.com/.-ssp|--susi-policy-id <ID>Princip-ID för inloggning och registrering för det här projektet. Använd med
IndividualB2Cautentisering.--aad-instance <INSTANCE>Azure Active Directory-instansen att ansluta till. Använd med
SingleOrgautentisering. Standardvärdet ärhttps://login.microsoftonline.com/.--client-id <ID>Klient-ID för det här projektet. Använd med
IndividualB2C,SingleOrgellerIndividualautentisering i fristående scenarier. Standardvärdet är33333333-3333-3333-33333333333333333.--domain <DOMAIN>Domänen för katalogklientorganisationen. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet ärqualified.domain.name.--app-id-uri <URI>App-ID-URI:n för det server-API som du vill anropa. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet ärapi.id.uri.--api-client-id <ID>Klient-ID:t för det API som servern är värd för. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet är11111111-1111-1111-11111111111111111.-s|--default-scope <SCOPE>API-omfånget som klienten måste begära för att etablera en åtkomsttoken. Använd med
SingleOrgellerIndividualB2Cautentisering. Standardvärdet äruser_impersonation.--tenant-id <ID>TenantId-ID:t för katalogen som ska anslutas till. Använd med
SingleOrgautentisering. Standardvärdet är22222222-2222-2222-2222-222222222222.-r|--org-read-accessTillåter det här programmet läsåtkomst till katalogen. Gäller endast för
SingleOrgautentisering.--exclude-launch-settingsExkluderar launchSettings.json från den genererade mallen.
-p|--pwaskapar en PWA (Progressive Web Application) som stöder installation och offlineanvändning.
--no-httpsInaktiverar HTTPS. Det här alternativet gäller endast om
Individual,IndividualB2CellerSingleOrginte används för--auth.-uld|--use-local-dbAnger att LocalDB ska användas i stället för SQLite. Gäller endast för
IndividualellerIndividualB2Cautentisering.--called-api-url <URL>URL för API:et som ska anropas från webbappen. Gäller endast för eller
SingleOrgautentisering utan attIndividualB2Cen ASP.NET Core-värd har angetts. Standardvärdet ärhttps://graph.microsoft.com/v1.0/me.--calls-graphAnger om webbappen anropar Microsoft Graph. Gäller endast för
SingleOrgautentisering.--called-api-scopes <SCOPES>Omfattningar för att begära att anropa API:et från webbappen. Gäller endast för eller
SingleOrgautentisering utan attIndividualB2Cen ASP.NET Core-värd har angetts. Standardvärdet äruser.read.--kestrelHttpPortPortnummer som ska användas för HTTP-slutpunkten i launchSettings.json.
--kestrelHttpsPortPortnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern
no-httpsanvänds (menno-httpsignoreras när en inställning för individuell eller organisatorisk autentisering väljs för--auth).--use-program-mainOm det anges används en explicit
Programklass ochMainmetod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde:false.