Dela via


Standardmallar för dotnet new

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.

  • --inherit

    Om 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-artifacts

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

  • --inherit

    Om 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.0
    8.0 net8.0
    7.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.

    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 console projekt som riktar sig mot netcoreapp1.0kör du dotnet new installMicrosoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Anger egenskapen LangVersion i den skapade projektfilen. Använd till exempel --langVersion 7.3 för att använda C# 7.3. Stöds inte för F#.

    En lista över C#-standardversioner finns i Standardinställningar.

  • --no-restore

    Om det anges kör du inte en implicit återställning när projektet skapas.

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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, eller net7.0 för att skapa ett .NET-klassbibliotek eller netstandard2.1netstandard2.0 för att skapa ett .NET Standard-klassbibliotek. Standardvärdet för .NET SDK 9.0.x ä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 --framework finns i för console projekt tidigare i den här artikeln.

  • --langVersion <VERSION_NUMBER>

    Anger egenskapen LangVersion i den skapade projektfilen. Använd till exempel --langVersion 7.3 för att använda C# 7.3. Stöds inte för F#.

    En lista över C#-standardversioner finns i Standardinställningar.

  • --no-restore

    Kö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 LangVersion i den skapade projektfilen. Använd till exempel --langVersion 7.3 för att använda C# 7.3.

    En lista över C#-standardversioner finns i Standardinställningar.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.


winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Anger egenskapen LangVersion i den skapade projektfilen. Använd till exempel --langVersion 7.3 för att använda C# 7.3.

    En lista över C#-standardversioner finns i Standardinställningar.

  • --no-restore

    Kö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 --framework finns i för console projekt tidigare i den här artikeln.

  • --exclude-launch-settings

    Exkluderar launchSettings.json från den genererade mallen.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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.0
    8.0 net8.0
    7.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-restore

    Kör inte en implicit återställning när projektet skapas.

  • --sdk

    Anvä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-pack

    Aktiverar 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.0
    8.0 net8.0
    7.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-pack

    Aktiverar paketering för projektet med hjälp av dotnet-paketet.

  • --no-restore

    Kö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.0
    8.0 net8.0
    7.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-pack

    Aktiverar paketering för projektet med hjälp av dotnet-paketet.

  • --no-restore

    Kö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-pagemodel

    Skapar 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-restore

    Kör inte en implicit återställning när projektet skapas.

  • --exclude-launch-settings

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

    Utelä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-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för Individual autentisering.

  • -ai|--all-interactive

    Gö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|--interactivity alternativet inte är inställt på None.

  • --no-https

    Inaktiverar HTTPS. Det här alternativet gäller endast om Individual inte har valts för alternativet -au|--auth .

  • --use-program-main

    Om det anges genereras en explicit Program klass och Main metod i stället för toppnivåinstruktioner.


web

  • --exclude-launch-settings

    Exkluderar 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.0
    8.0 net8.0
    7.0 net7.0

    Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder --framework finns i för console projekt tidigare i den här artikeln.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --no-https

    Inaktiverar HTTPS.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten i launchSettings.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern no-https används (men no-https ignoreras när en inställning för individuell eller organisatorisk autentisering väljs för --auth).

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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 IndividualB2C autentisering. Standardvärdet är https://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 IndividualB2C autentisering.

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

    Princip-ID för återställning av lösenord för det här projektet. Använd med IndividualB2C autentisering.

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

    Redigera profilprincip-ID för det här projektet. Använd med IndividualB2C autentisering.

  • --aad-instance <INSTANCE>

    Azure Active Directory-instansen att ansluta till. Använd med SingleOrg eller MultiOrg autentisering. Standardvärdet är https://login.microsoftonline.com/.

  • --client-id <ID>

    Klient-ID för det här projektet. Använd med IndividualB2C, SingleOrgeller MultiOrg autentisering. Standardvärdet är 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Domänen för katalogklientorganisationen. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är qualified.domain.name.

  • --tenant-id <ID>

    TenantId-ID:t för katalogen som ska anslutas till. Använd med SingleOrg autentisering. Standardvärdet är 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Begärandesökvägen i programmets bassökväg för omdirigerings-URI:n. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är /signin-oidc.

  • -r|--org-read-access

    Tillåter det här programmet läsåtkomst till katalogen. Gäller endast för SingleOrg eller MultiOrg autentisering.

  • --exclude-launch-settings

    Exkluderar launchSettings.json från den genererade mallen.

  • --no-https

    Inaktiverar HTTPS. Det här alternativet gäller endast om Individual, IndividualB2C, SingleOrgeller MultiOrg inte används.

  • -uld|--use-local-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för Individual eller IndividualB2C autentisering.

  • -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.0
    8.0 net8.0
    7.0 net7.0

    Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder --framework finns i för console projekt tidigare i den här artikeln.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --use-browserlink

    Innehåller BrowserLink i projektet.

  • -rrc|--razor-runtime-compilation

    Avgör om projektet är konfigurerat för att använda Razor-körningskompilering i felsökningsversioner.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten i launchSettings.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern no-https används (men no-https ignoreras när en inställning för individuell eller organisatorisk autentisering väljs för --auth).

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde: false.


razorclasslib

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

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

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

    Exkluderar 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.0
    8.0 net8.0
  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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 IndividualB2C autentisering. Standardvärdet är https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Skapa 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 skapar falseinmatning dotnet new webapi utan 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 IndividualB2C autentisering.

  • --aad-instance <INSTANCE>

    Azure Active Directory-instansen att ansluta till. Använd med SingleOrg autentisering. Standardvärdet är https://login.microsoftonline.com/.

  • --client-id <ID>

    Klient-ID för det här projektet. Använd med IndividualB2C eller SingleOrg autentisering. Standardvärdet är 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Om du vill använda kontrollanter i stället för minimala API:er. Om både det här alternativet och -minimal anges åsidosätter det här alternativet det värde som anges av -minimal. Standard är false. Tillgänglig sedan .NET 8 SDK.

  • --domain <DOMAIN>

    Domänen för katalogklientorganisationen. Använd med IndividualB2C eller SingleOrg autentisering. Standardvärdet är qualified.domain.name.

  • --tenant-id <ID>

    TenantId-ID:t för katalogen som ska anslutas till. Använd med SingleOrg autentisering. Standardvärdet är 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Tillåter det här programmet läsåtkomst till katalogen. Gäller endast för SingleOrg autentisering.

  • --exclude-launch-settings

    Exkluderar launchSettings.json från den genererade mallen.

  • --no-openapi

    Inaktiverar Stöd för OpenAPI (Swagger). AddOpenApi och MapOpenApi anropas inte.

  • --no-https

    Inaktiverar HTTPS. Ingen https-startprofil skapas i launchSettings.json. app.UseHstsoch app.UseHttpsRedirection anropas inte i Program.cs/Startup.cs. Det här alternativet gäller endast om IndividualB2C eller SingleOrg inte används för autentisering.

  • -uld|--use-local-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för IndividualB2C autentisering.

  • -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.0
    8.0 net8.0
    7.0 net7.0

    Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder --framework finns i för console projekt tidigare i den här artikeln.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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|--actions

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

  • --empty

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

    Exkluderar launchSettings.json från den genererade mallen.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --no-https

    Inaktiverar HTTPS. Det här alternativet gäller endast om autentisering är None.

  • -uld|--use-local-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för Individual eller IndividualB2C autentisering.

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

    Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder --framework finns i för console projekt tidigare i den här artikeln.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten i launchSettings.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern no-https används (men no-https ignoreras när en inställning för individuell eller organisatorisk autentisering väljs för --auth).

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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änder SingleOrgockså .
    • MultiOrg – Organisationsautentisering för flera klienter.
    • Windows – Windows-autentisering.
  • --aad-b2c-instance <INSTANCE>

    Azure Active Directory B2C-instansen att ansluta till. Använd med IndividualB2C autentisering. Standardvärdet är https://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 IndividualB2C autentisering.

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

    Princip-ID för återställning av lösenord för det här projektet. Använd med IndividualB2C autentisering.

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

    Redigera profilprincip-ID för det här projektet. Använd med IndividualB2C autentisering.

  • --aad-instance <INSTANCE>

    Azure Active Directory-instansen att ansluta till. Använd med SingleOrg eller MultiOrg autentisering. Standardvärdet är https://login.microsoftonline.com/.

  • --client-id <ID>

    Klient-ID för det här projektet. Använd med IndividualB2C, SingleOrgeller MultiOrg autentisering. Standardvärdet är 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Domänen för katalogklientorganisationen. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är qualified.domain.name.

  • --tenant-id <ID>

    TenantId-ID:t för katalogen som ska anslutas till. Använd med SingleOrg autentisering. Standardvärdet är 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Begärandesökvägen i programmets bassökväg för omdirigerings-URI:n. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är /signin-oidc.

  • -r|--org-read-access

    Tillåter det här programmet läsåtkomst till katalogen. Gäller endast för SingleOrg eller MultiOrg autentisering.

  • --exclude-launch-settings

    Exkluderar launchSettings.json från den genererade mallen.

  • --no-https

    Inaktiverar HTTPS. Det här alternativet gäller endast om Individual, IndividualB2C, SingleOrgeller MultiOrg inte används för --auth.

  • -uld|--use-local-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för Individual eller IndividualB2C autentisering.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten i launchSettings.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern no-https används (men no-https ignoreras när en inställning för individuell eller organisatorisk autentisering väljs för --auth).

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod 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.0
    8.0 net8.0
    7.0 net7.0

    Information om hur du skapar ett projekt som är avsett för ett tidigare ramverk än det SDK som du använder --framework finns i för console projekt tidigare i den här artikeln.

  • --no-restore

    Kör inte en implicit återställning när projektet skapas.

  • -ho|--hosted

    Innehå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 Individual autentisering. Standardvärdet är https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Azure Active Directory B2C-instansen att ansluta till. Använd med IndividualB2C autentisering. Standardvärdet är https://aadB2CInstance.b2clogin.com/.

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

    Princip-ID för inloggning och registrering för det här projektet. Använd med IndividualB2C autentisering.

  • --aad-instance <INSTANCE>

    Azure Active Directory-instansen att ansluta till. Använd med SingleOrg autentisering. Standardvärdet är https://login.microsoftonline.com/.

  • --client-id <ID>

    Klient-ID för det här projektet. Använd med IndividualB2C, SingleOrgeller Individual autentisering i fristående scenarier. Standardvärdet är 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Domänen för katalogklientorganisationen. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är qualified.domain.name.

  • --app-id-uri <URI>

    App-ID-URI:n för det server-API som du vill anropa. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är api.id.uri.

  • --api-client-id <ID>

    Klient-ID:t för det API som servern är värd för. Använd med SingleOrg eller IndividualB2C autentisering. Standardvärdet är 11111111-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 SingleOrg eller IndividualB2C autentisering. Standardvärdet är user_impersonation.

  • --tenant-id <ID>

    TenantId-ID:t för katalogen som ska anslutas till. Använd med SingleOrg autentisering. Standardvärdet är 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Tillåter det här programmet läsåtkomst till katalogen. Gäller endast för SingleOrg autentisering.

  • --exclude-launch-settings

    Exkluderar launchSettings.json från den genererade mallen.

  • -p|--pwa

    skapar en PWA (Progressive Web Application) som stöder installation och offlineanvändning.

  • --no-https

    Inaktiverar HTTPS. Det här alternativet gäller endast om Individual, IndividualB2Celler SingleOrg inte används för --auth.

  • -uld|--use-local-db

    Anger att LocalDB ska användas i stället för SQLite. Gäller endast för Individual eller IndividualB2C autentisering.

  • --called-api-url <URL>

    URL för API:et som ska anropas från webbappen. Gäller endast för eller SingleOrg autentisering utan att IndividualB2C en ASP.NET Core-värd har angetts. Standardvärdet är https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Anger om webbappen anropar Microsoft Graph. Gäller endast för SingleOrg autentisering.

  • --called-api-scopes <SCOPES>

    Omfattningar för att begära att anropa API:et från webbappen. Gäller endast för eller SingleOrg autentisering utan att IndividualB2C en ASP.NET Core-värd har angetts. Standardvärdet är user.read.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten i launchSettings.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten i launchSettings.json. Det här alternativet gäller inte när parametern no-https används (men no-https ignoreras när en inställning för individuell eller organisatorisk autentisering väljs för --auth).

  • --use-program-main

    Om det anges används en explicit Program klass och Main metod i stället för toppnivåinstruktioner. Tillgänglig sedan .NET SDK 6.0.300. Standardvärde: false.


Se även