.NET-standardmallar för dotnet new

  • Artikel

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

I följande tabell visas de mallar som är förinstallerade med .NET SDK. Standardspråket för mallen visas inom hakparenteserna. Klicka på den korta namnlänken för att se de specifika mallalternativen.

Mallar Kort namn Språk Taggar Introducerade
Konsolprogram console [C#], F#, VB Common/Console 1.0
Klassbibliotek classlib [C#], F#, VB Common/Library 1.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)
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
Projekt för enhetstest mstest [C#], F#, VB Test/MSTest 1.0
NUnit 3-testprojekt nunit [C#], F#, VB Test/NUnit 2.1.400
NUnit 3-testobjekt nunit-test [C#], F#, VB Test/NUnit 2,2
xUnit-testprojekt xunit [C#], F#, VB Test/xUnit 1.0
Razor-komponent razorcomponent [C#] Webb/ASP.NET 3,0
Razor-sida page [C#] Webb/ASP.NET 2.0
MVC-vyImporter viewimports [C#] Webb/ASP.NET 2.0
MVC ViewStart viewstart [C#] Webb/ASP.NET 2.0
Blazor Webbapp blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Fristående app blazorwasm [C#] Webb/Blazor/WebAssembly/PWA 3.1.300
ASP.NET Core Tom web [C#], F# Webb/tom 1.0
ASP.NET Core Web App (Model-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
Razor Class Library razorclasslib [C#] Webb/Razor/Bibliotek/Razor-klassbibliotek 2.1
ASP.NET Core Web API webapi [C#], F# Webb-/webb-API/API/Tjänst/WebAPI 1.0
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 gRPC-tjänsten grpc [C#] Webb/gRPC 3,0
dotnet gitignore-fil gitignore Konfigurera 3,0
global.json fil globaljson Konfigurera 2.0
NuGet-konfiguration nugetconfig Konfigurera 1.0
Dotnet-manifestfil för lokalt verktyg tool-manifest Konfigurera 3,0
Webbkonfiguration webconfig Konfigurera 1.0
Lösningsfil sln Lösning 1.0
Protokollbuffertfil proto Webb/gRPC 3,0
EditorConfig-fil editorconfig Konfigurera 6,0

I följande tabell visas mallar som har upphört och som inte längre är förinstallerade med .NET SDK. Klicka på den korta namnlänken för att se de specifika mallalternativen.

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#] Web/Blazor 8.0
Blazor Serverappen är tom blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly Appen är tom blazorwasm-empty [C#] Webb/Blazor/WebAssembly 8.0

Mallalternativ

Varje mall kan ha ytterligare 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. Om mallen stöder flera språk visar det här kommandot 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#. Mallarna som levereras med .NET SDK har följande ytterligare alternativ:

console

  • -f|--framework <FRAMEWORK>

    Anger det ramverk som ska riktas. Tillgänglig sedan .NET Core 3.0 SDK.

    I följande tabell visas standardvärdena enligt den SDK-version som du använder:

    SDK-version Standardvärde
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    3.1 netcoreapp3.1

    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 .NET 7 SDK installerat är net7.0det enda tillgängliga värdet för --framework . Om du installerar .NET 6 SDK blir värdet net6.0 tillgängligt för --framework. Om du installerar .NET Core 3.1 SDK netcoreapp3.1 blir det tillgängligt och så vidare. Så genom att --framework netcoreapp3.1 ange kan du rikta in dig på .NET Core 3.1 även när du kör dotnet new i .NET 6 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 install på Microsoft.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#. Tillgänglig sedan .NET Core 2.2 SDK.

    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. Tillgänglig sedan .NET Core 2.2 SDK.

  • --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: net8.0, net7.0, eller net6.0 för att skapa ett .NET-klassbibliotek eller netstandard2.0netstandard2.1 för att skapa ett .NET Standard-klassbibliotek. Standardvärdet för .NET SDK 8.0.x är net8.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#. Tillgänglig sedan .NET Core 2.2 SDK.

    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 8 SDK är net8.0standardvärdet . Tillgänglig sedan .NET Core 3.1 SDK.

  • --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 8 SDK är net8.0. Tillgänglig sedan .NET Core 3.1 SDK.

    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 start Inställningar.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, xunit

  • -f|--framework <FRAMEWORK>

    Anger det ramverk som ska riktas. Alternativet är tillgängligt sedan .NET Core 3.0 SDK.

    I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:

    SDK-version Standardvärde
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

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 .NET 6 SDK installerat är net6.0det enda tillgängliga värdet för --framework . Om du installerar .NET 5 SDK blir värdet net5.0 tillgängligt för --framework. Om du installerar .NET Core 3.1 SDK netcoreapp3.1 blir det tillgängligt och så vidare. Så genom att --framework netcoreapp3.1 ange kan du rikta in dig på .NET Core 3.1 även när du kör dotnet new i .NET 6 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
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

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 .NET 6 SDK installerat är net6.0det enda tillgängliga värdet för --framework . Om du installerar .NET 5 SDK blir värdet net5.0 tillgängligt för --framework. Om du installerar .NET Core 3.1 SDK netcoreapp3.1 blir det tillgängligt och så vidare. Så genom att --framework netcoreapp3.1 ange kan du rikta in dig på .NET Core 3.1 även när du kör dotnet new i .NET 6 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.

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 start Inställningar.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 vid start Inställningar.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten vid start Inställningar.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.

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

    Utesluter start Inställningar.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.

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

    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 start Inställningar.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 IndividualB2C autentisering utan att SingleOrg 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 IndividualB2C autentisering utan att SingleOrg en ASP.NET Core-värd har angetts. Standardvärdet är user.read.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten vid start Inställningar.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten vid start Inställningar.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.

web

  • --exclude-launch-settings

    Exkluderar start Inställningar.json från den genererade mallen.

  • -f|--framework <FRAMEWORK>

    Anger det ramverk som ska riktas. Alternativet är inte tillgängligt i .NET Core 2.2 SDK.

    I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:

    SDK-version Standardvärde
    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

    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 vid start Inställningar.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten vid start Inställningar.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 start Inställningar.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. Alternativet är tillgängligt sedan .NET Core 3.0 SDK.

    I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:

    SDK-version Standardvärde
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.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. Alternativet är inte tillgängligt i .NET Core 2.2 och 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Avgör om projektet är konfigurerat för att använda Razor-körningskompilering i felsökningsversioner. Alternativet är tillgängligt sedan .NET Core 3.1.201 SDK.

  • --kestrelHttpPort

    Portnummer som ska användas för HTTP-slutpunkten vid start Inställningar.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten vid start Inställningar.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.

angular, react

Har upphört sedan .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Den typ av autentisering som ska användas. Tillgänglig sedan .NET Core 3.0 SDK.

    Möjliga värden är:

    • None – Ingen autentisering (standard).
    • Individual – Individuell autentisering.

  • --exclude-launch-settings

    Exkluderar start Inställningar.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. Tillgänglig sedan .NET Core 3.0 SDK.

  • -f|--framework <FRAMEWORK>

    Anger det ramverk som ska riktas. Alternativet är inte tillgängligt i .NET Core 2.2 SDK.

    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
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0
    2.1 netcoreapp2.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 vid start Inställningar.json.

  • --kestrelHttpsPort

    Portnummer som ska användas för HTTPS-slutpunkten vid start Inställningar.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. Tillgänglig sedan .NET Core 3.0 SDK.

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 start Inställningar.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
    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 start Inställningar.json från den genererade mallen.

  • --no-openapi

    Inaktiverar Stöd för OpenAPI (Swagger). AddSwaggerGen, UseSwaggeroch UseSwaggerUI 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. Alternativet är inte tillgängligt i .NET Core 2.2 SDK.

    I följande tabell visas standardvärdena enligt det SDK-versionsnummer som du använder:

    SDK-version Standardvärde
    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

    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 .

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.

Se även