Megosztás a következőn keresztül:

.NET alapértelmezett sablonok az új dotnethez

  • Cikk

A .NET SDK telepítésekor több mint egy tucat beépített sablont kap projektek és fájlok létrehozásához, beleértve a konzolalkalmazásokat, osztálytárakat, egységtesztelési projekteket, ASP.NET Core-alkalmazásokat (beleértve az Angular- és React-projekteket) és a konfigurációs fájlokat. A beépített sablonok listázásához futtassa a dotnet new list következő parancsot:

dotnet new list

Az alábbi táblázat a .NET SDK-val előre telepített sablonokat mutatja be. A sablon alapértelmezett nyelve a zárójeleken belül jelenik meg. Kattintson a rövid névhivatkozásra az adott sablonbeállítások megtekintéséhez.

Sablonok Rövid név Nyelv Címkék Bevezetett
Konzolalkalmazás console [C#], F#, VB Common/Console 1.0
Osztálytár classlib [C#], F#, VB Common/Library 1.0
WPF-alkalmazás wpf [C#], VB Common/WPF 3.0 (VB esetén 5.0)
WPF-osztálykódtár wpflib [C#], VB Common/WPF 3.0 (VB esetén 5.0)
WPF egyéni vezérlőtár wpfcustomcontrollib [C#], VB Common/WPF 3.0 (VB esetén 5.0)
WPF felhasználói vezérlőtár wpfusercontrollib [C#], VB Common/WPF 3.0 (VB esetén 5.0)
Windows Forms (WinForms) alkalmazás winforms [C#], VB Common/WinForms 3.0 (VB esetén 5.0)
Windows Forms (WinForms) osztálytár winformslib [C#], VB Common/WinForms 3.0 (VB esetén 5.0)
Feldolgozói szolgáltatás worker [C#] Common/Worker/Web 3,0
MSTest tesztprojekt mstest [C#], F#, VB Teszt/MSTest 1.0
MSTest tesztosztály mstest-class [C#], F#, VB Teszt/MSTest 1.0
NUnit 3 tesztprojekt nunit [C#], F#, VB Teszt/NUnit 2.1.400
NUnit 3 tesztelem nunit-test [C#], F#, VB Teszt/NUnit 2,2
xUnit tesztprojekt xunit [C#], F#, VB Teszt/xUnit 1.0
Razor-összetevő razorcomponent [C#] Web/ASP.NET 3,0
Razor-oldal page [C#] Web/ASP.NET 2,0
MVC-nézetimportok viewimports [C#] Web/ASP.NET 2,0
MVC ViewStart viewstart [C#] Web/ASP.NET 2,0
Blazor Webalkalmazás blazor [C#] Web/Blazor 8.0.100
Blazor WebAssembly Önálló alkalmazás blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
ASP.NET Core Empty web [C#], F# Web/Üres 1.0
ASP.NET Core Web App (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
ASP.NET Core Web App webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
Razor-osztálytár razorclasslib [C#] Web/Razor/Library/Razor osztálykönyvtár 2.1
ASP.NET Core, webes API webapi [C#], F# Web/Web API/API/Szolgáltatás/WebAPI 1.0
ASP.NET Core API webapiaot [C#] Web/Web API/API/Szolgáltatás 8.0
ASP.NET Core API-vezérlő apicontroller [C#] Web/ASP.NET 8.0
ASP.NET Core gRPC szolgáltatás grpc [C#] Web/gRPC 3,0
dotnet gitignore fájl gitignore Konfigurálás 3,0
global.json fájl globaljson Konfigurálás 2,0
NuGet Config nugetconfig Konfigurálás 1.0
Dotnet local tool manifest file tool-manifest Konfigurálás 3,0
Webes konfiguráció webconfig Konfigurálás 1.0
Megoldásfájl sln Megoldás 1.0
Protokollpufferfájl proto Web/gRPC 3,0
Szerkesztőkonfigurációs fájl editorconfig Konfigurálás 6,0

Az alábbi táblázat a már megszüntetett és a .NET SDK-val már nem előre telepített sablonokat mutatja be. Kattintson a rövid névhivatkozásra az adott sablonbeállítások megtekintéséhez.

Sablonok Rövid név Nyelv Címkék Azóta megszűnt
ASP.NET Core és Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core with React.js react [C#] Web/MVC/SPA 8.0
Blazor Kiszolgálóalkalmazás blazorserver [C#] Web/Blazor 8.0
Blazor Kiszolgálóalkalmazás üres blazorserver-empty [C#] Web/Blazor 8.0
Blazor WebAssembly Alkalmazás üres blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Sablonbeállítások

Előfordulhat, hogy minden sablon további lehetőségeket is kínál. A sablonhoz elérhető további lehetőségek megjelenítéséhez használja a --help sablonnév argumentumot, például: dotnet new console --help. Ha a sablon több nyelvet is támogat, ez a parancs az alapértelmezett nyelven jeleníti meg a sablon súgóját. Ha kombinálja a --language beállítással, más nyelvek súgója is megjelenik: dotnet new console --help --language F#. A .NET SDK-val szállított sablonok a következő további lehetőségeket kínálják:

console

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A .NET Core 3.0 SDK óta érhető el.

    Az alábbi táblázat a használt SDK-verziónak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    A projekt korábbi TFM-hez való létrehozásának lehetősége attól függ, hogy telepítve van-e az SDK ezen verziója. Ha például csak a .NET 9 SDK van telepítve, akkor a --framework csak net9.0érték érhető el. Ha például telepíti a .NET 8 SDK-t, a net8.0 érték elérhetővé válik --frameworkszámára. A --framework net8.0 megadásával a .NET 8-at akkor is megcélzhatja, ha dotnet new fut a .NET 9 SDK-ban.

    Másik lehetőségként, ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, ezt megteheti a sablonHoz tartozó NuGet-csomag telepítésével. A gyakori webes és SPA-projekttípusok cél-keretrendszer-monikerenként (TFM) különböző csomagokat használnak. Például egy console célként szolgáló netcoreapp1.0projekt létrehozásához futtassa a következőtdotnet new installMicrosoft.DotNet.Common.ProjectTemplates.1.x: .

  • --langVersion <VERSION_NUMBER>

    Beállítja a LangVersion tulajdonságot a létrehozott projektfájlban. Használja például --langVersion 7.3 a C# 7.3-at. Az F# nem támogatott.

    Az alapértelmezett C#-verziók listáját az Alapértelmezettek című témakörben találja.

  • --no-restore

    Ha meg van adva, nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false. Csak C# esetén érhető el.

classlib

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . Értékek: net9.0, net8.0vagy net7.0 .NET-osztálytár létrehozása vagy netstandard2.1netstandard2.0 .NET Standard osztálytár létrehozása. A .NET SDK 9.0.x alapértelmezett értéke net9.0.

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --langVersion <VERSION_NUMBER>

    Beállítja a LangVersion tulajdonságot a létrehozott projektfájlban. Használja például --langVersion 7.3 a C# 7.3-at. Az F# nem támogatott.

    Az alapértelmezett C#-verziók listáját az Alapértelmezettek című témakörben találja.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

wpf, wpflib, wpfcustomcontrollibwpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A .NET 9 SDK esetében az alapértelmezett érték net9.0.

  • --langVersion <VERSION_NUMBER>

    Beállítja a LangVersion tulajdonságot a létrehozott projektfájlban. Használja például --langVersion 7.3 a C# 7.3-at.

    Az alapértelmezett C#-verziók listáját az Alapértelmezettek című témakörben találja.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Beállítja a LangVersion tulajdonságot a létrehozott projektfájlban. Használja például --langVersion 7.3 a C# 7.3-at.

    Az alapértelmezett C#-verziók listáját az Alapértelmezettek című témakörben találja.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A .NET 9 SDK alapértelmezett értéke net9.0.

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

mstest

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

A projekt korábbi TFM-hez való létrehozásának lehetősége attól függ, hogy telepítve van-e az SDK ezen verziója. Ha például csak a .NET 9 SDK van telepítve, akkor a --framework csak net9.0érték érhető el. Ha például a .NET 8 SDK-t telepíti, a net8.0 érték elérhetővé válik --frameworkszámára. A --framework net8.0 megadásával a .NET 8-at akkor is megcélzhatja, ha dotnet new fut a .NET 9 SDK-ban.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --sdk

    MSTest.Sdk projektstílus használata.

  • --test-runner <TEST_RUNNER>

    A tesztprojekt futója/platformja. A lehetséges értékek a következők:

    • VSTest - VSTest platform (alapértelmezett).
    • MSTest – Microsoft.Testing.Platform.

  • --coverage-tool <COVERAGE_TOOL>

    A tesztprojekthez használandó lefedettségi eszköz. A lehetséges értékek a következők:

    • Microsoft.CodeCoverage - Microsoft-kódlefedettség (alapértelmezett).
    • coverlet - fedéllefedettségi eszköz.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Az SDK-bővítményprofil a Microsoft.Testing.Platform használatakor. A lehetséges értékek a következők:

    • Default - Alapértelmezett bővítményprofil (alapértelmezett).
    • None - Nincs engedélyezve bővítmény.
    • AllMicrosoft – Engedélyezze a Microsoft által szállított összes bővítményt (beleértve a korlátozó licenccel rendelkező bővítményeket is).

  • --fixture <FIXTURE>

    A tesztprojektbe belefoglalandó fixture-típusok. A lehetséges értékek a következők:

    • None - Nincsenek rögzítési módszerek.
    • AssemblyInitialize - AssemblyInitialize fixture metódus.
    • AssemblyCleanup - AssemblyCleanup fixture metódus.
    • ClassInitialize - ClassInitialize fixture metódus.
    • ClassCleanup - ClassCleanup fixture metódus.
    • TestInitialize - TestInitialize fixture metódus.
    • TestCleanup - TestCleanup fixture metódus.

    Ahol több érték is engedélyezett.

  • -p|--enable-pack

    Lehetővé teszi a projekt csomagolását dotnet-csomag használatával.

mstest-class

  • --fixture <FIXTURE>

    A tesztprojektbe belefoglalandó fixture-típusok. A lehetséges értékek a következők:

    • None - Nincsenek rögzítési módszerek.
    • AssemblyInitialize - AssemblyInitialize fixture metódus.
    • AssemblyCleanup - AssemblyCleanup fixture metódus.
    • ClassInitialize - ClassInitialize fixture metódus.
    • ClassCleanup - ClassCleanup fixture metódus.
    • TestInitialize - TestInitialize fixture metódus.
    • TestCleanup - TestCleanup fixture metódus.

    Ahol több érték is engedélyezett.

xunit

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

A projekt korábbi TFM-hez való létrehozásának lehetősége attól függ, hogy telepítve van-e az SDK ezen verziója. Ha például csak a .NET 9 SDK van telepítve, akkor a --framework csak net9.0érték érhető el. Ha például a .NET 8 SDK-t telepíti, a net8.0 érték elérhetővé válik --frameworkszámára. A --framework net8.0 megadásával a .NET 8-at akkor is megcélzhatja, ha dotnet new fut a .NET 9 SDK-ban.

  • -p|--enable-pack

    Lehetővé teszi a projekt csomagolását dotnet-csomag használatával.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

nunit

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

A projekt korábbi TFM-hez való létrehozásának lehetősége attól függ, hogy telepítve van-e az SDK ezen verziója. Ha például csak a .NET 9 SDK van telepítve, akkor a --framework csak net9.0érték érhető el. Ha például a .NET 8 SDK-t telepíti, a net8.0 érték elérhetővé válik --frameworkszámára. A --framework net8.0 megadásával a .NET 8-at akkor is megcélzhatja, ha dotnet new fut a .NET 9 SDK-ban.

  • -p|--enable-pack

    Lehetővé teszi a projekt csomagolását dotnet-csomag használatával.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

page

  • -na|--namespace <NAMESPACE_NAME>

    A létrehozott kód névtere. Az alapértelmezett érték MyApp.Namespace.

  • -np|--no-pagemodel

    PageModel nélkül hozza létre a lapot.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    A létrehozott kód névtere. Az alapértelmezett érték MyApp.Namespace.

blazorserver

A .NET 8 SDK óta megszűnt.

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa. A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • Individual - Egyéni hitelesítés.
    • IndividualB2C - Egyéni hitelesítés az Azure AD B2C-vel.
    • SingleOrg - Szervezeti hitelesítés egyetlen bérlőhöz. Az Entra külső azonosító bérlői is használják SingleOrg.
    • MultiOrg - Több bérlő szervezeti hitelesítése.
    • Windows - Windows-hitelesítés.

  • --aad-b2c-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory B2C-példány. Hitelesítéssel használható IndividualB2C . Az alapértelmezett érték https://login.microsoftonline.com/tfp/.

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

    A projekt bejelentkezési és regisztrációs házirend-azonosítója. Hitelesítéssel használható IndividualB2C .

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

    A projekt új jelszóházirend-azonosítója. Hitelesítéssel használható IndividualB2C .

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

    A projekthez tartozó profilszabályzat-azonosító. Hitelesítéssel használható IndividualB2C .

  • --aad-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory-példány. Használjon vagy SingleOrg hitelesítésselMultiOrg. Az alapértelmezett érték https://login.microsoftonline.com/.

  • --client-id <ID>

    A projekt ügyfélazonosítója. Használjon , IndividualB2Cvagy SingleOrg hitelesítésselMultiOrg. Az alapértelmezett érték 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    A címtár-bérlő tartománya. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték qualified.domain.name.

  • --tenant-id <ID>

    Annak a könyvtárnak a TenantId azonosítója, amelyhez csatlakozni szeretne. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    A kérelem elérési útja az átirányítási URI alapútvonalán belül. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték /signin-oidc.

  • -r|--org-read-access

    Lehetővé teszi, hogy az alkalmazás olvasási hozzáférést biztosítson a címtárhoz. Csak a hitelesítésre vagy SingleOrg a hitelesítésre MultiOrg vonatkozik.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • --no-https

    Kikapcsolja a HTTPS-t. Ez a beállítás csak akkor érvényes, ha Individual, IndividualB2Cvagy SingleOrgMultiOrgnincs használatban .--auth

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre vagy Individual a hitelesítésre IndividualB2C vonatkozik.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --kestrelHttpPort

    A HTTP-végponthoz használandó portszám a launchSettings.json.

  • --kestrelHttpsPort

    A HTTPS-végponthoz launchSettings.json használandó portszám. Ez a beállítás nem alkalmazható a paraméter no-https használatakor (de no-https a rendszer figyelmen kívül hagyja, ha egyéni vagy szervezeti hitelesítési beállítást választ --auth).

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

blazor

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Ez a sablon a .NET 8-as vagy újabb verziójához érhető el.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott alkalmazásból.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Meghatározza, hogy melyik interaktív renderelési módot használja az interaktív összetevőkhöz. A lehetséges értékek a következők:

    • None - Nincs interaktivitás (csak statikus kiszolgálóoldali renderelés).
    • Server - (Alapértelmezett) Az alkalmazást interaktív kiszolgálóoldali rendereléssel futtatja a kiszolgálón.
    • WebAssembly - Az alkalmazást ügyféloldali renderelés használatával futtatja a böngészőben a következővel WebAssembly: .
    • Auto – Interaktív kiszolgálóoldali renderelést használ a Blazor csomag letöltése és a Blazor futtatókörnyezet aktiválása közben az ügyfélen, majd ügyféloldali renderelést használ a következővel WebAssembly: .

  • --empty

    Kihagyja az alapszintű használati mintákat szemléltető mintalapokat és stílusokat.

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa. A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • Individual - Egyéni hitelesítés.

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre Individual vonatkozik.

  • -ai|--all-interactive

    Minden oldal interaktívvá válik egy interaktív renderelési mód felső szinten való alkalmazásával. Ha falsea lapok alapértelmezés szerint statikus kiszolgálóoldali renderelést használnak, és interaktívként jelölhetők meg oldalanként vagy összetevőnként. Ez a beállítás csak akkor érvényes, ha a -i|--interactivity beállítás nincs beállítva None.

  • --no-https

    Kikapcsolja a HTTPS-t. Ez a beállítás csak akkor érvényes, ha Individual nincs kiválasztva a -au|--auth beállításhoz.

  • --use-program-main

    Ha meg van adva, a rendszer a legfelső szintű utasítások helyett explicit Program osztályt és Main metódust hoz létre.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • -ho|--hosted

    Tartalmaz egy ASP.NET Core-gazdagépet az BlazorWebAssembly alkalmazáshoz.

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa. A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • Individual - Egyéni hitelesítés.
    • IndividualB2C - Egyéni hitelesítés az Azure AD B2C-vel.
    • SingleOrg - Szervezeti hitelesítés egyetlen bérlőhöz. Az Entra külső azonosító bérlői a SingleOrg-t is használják.

  • --authority <AUTHORITY>

    Az OIDC-szolgáltató hatósága. Hitelesítéssel használható Individual . Az alapértelmezett érték https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory B2C-példány. Hitelesítéssel használható IndividualB2C . Az alapértelmezett érték https://aadB2CInstance.b2clogin.com/.

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

    A projekt bejelentkezési és regisztrációs házirend-azonosítója. Hitelesítéssel használható IndividualB2C .

  • --aad-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory-példány. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték https://login.microsoftonline.com/.

  • --client-id <ID>

    A projekt ügyfélazonosítója. Használja a IndividualB2C, SingleOrgvagy Individual hitelesítést önálló forgatókönyvekben. Az alapértelmezett érték 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    A címtár-bérlő tartománya. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték qualified.domain.name.

  • --app-id-uri <URI>

    A meghívni kívánt kiszolgálói API alkalmazásazonosítója. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték api.id.uri.

  • --api-client-id <ID>

    A kiszolgáló által üzemeltetett API ügyfélazonosítója. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték 11111111-1111-1111-11111111111111111.

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

    Az az API-hatókör, amelyhez az ügyfélnek hozzáférési jogkivonatot kell kiépítenie. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték user_impersonation.

  • --tenant-id <ID>

    Annak a könyvtárnak a TenantId azonosítója, amelyhez csatlakozni szeretne. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Lehetővé teszi, hogy az alkalmazás olvasási hozzáférést biztosítson a címtárhoz. Csak a hitelesítésre SingleOrg vonatkozik.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • -p|--pwa

    a telepítést és az offline használatot támogató progresszív webalkalmazást (PWA) hoz létre.

  • --no-https

    Kikapcsolja a HTTPS-t. Ez a beállítás csak akkor érvényes, ha Individual, IndividualB2Cvagy SingleOrg nincs használatban .--auth

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre vagy Individual a hitelesítésre IndividualB2C vonatkozik.

  • --called-api-url <URL>

    A webalkalmazásból hívandó API URL-címe. Csak a SingleOrg megadott ASP.NET Core-gazdagépre vonatkozik vagy IndividualB2C hitelesítésre. Az alapértelmezett érték https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Megadja, hogy a webalkalmazás meghívja-e a Microsoft Graphot. Csak a hitelesítésre SingleOrg vonatkozik.

  • --called-api-scopes <SCOPES>

    Hatókörök az API webalkalmazásból való meghívásához. Csak a SingleOrg megadott ASP.NET Core-gazdagépre vonatkozik vagy IndividualB2C hitelesítésre. Az alapértelmezett érték user.read.

  • --kestrelHttpPort

    A HTTP-végponthoz használandó portszám a launchSettings.json.

  • --kestrelHttpsPort

    A HTTPS-végponthoz launchSettings.json használandó portszám. Ez a beállítás nem alkalmazható a paraméter no-https használatakor (de no-https a rendszer figyelmen kívül hagyja, ha egyéni vagy szervezeti hitelesítési beállítást választ --auth).

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

web

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A beállítás nem érhető el a .NET Core 2.2 SDK-ban.

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --no-https

    Kikapcsolja a HTTPS-t.

  • --kestrelHttpPort

    A HTTP-végponthoz használandó portszám a launchSettings.json.

  • --kestrelHttpsPort

    A HTTPS-végponthoz launchSettings.json használandó portszám. Ez a beállítás nem alkalmazható a paraméter no-https használatakor (de no-https a rendszer figyelmen kívül hagyja, ha egyéni vagy szervezeti hitelesítési beállítást választ --auth).

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa. A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • Individual - Egyéni hitelesítés.
    • IndividualB2C - Egyéni hitelesítés az Azure AD B2C-vel.
    • SingleOrg - Szervezeti hitelesítés egyetlen bérlőhöz. Az Entra külső azonosító bérlői a SingleOrg-t is használják.
    • MultiOrg - Több bérlő szervezeti hitelesítése.
    • Windows - Windows-hitelesítés.

  • --aad-b2c-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory B2C-példány. Hitelesítéssel használható IndividualB2C . Az alapértelmezett érték https://login.microsoftonline.com/tfp/.

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

    A projekt bejelentkezési és regisztrációs házirend-azonosítója. Hitelesítéssel használható IndividualB2C .

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

    A projekt új jelszóházirend-azonosítója. Hitelesítéssel használható IndividualB2C .

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

    A projekthez tartozó profilszabályzat-azonosító. Hitelesítéssel használható IndividualB2C .

  • --aad-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory-példány. Használjon vagy SingleOrg hitelesítésselMultiOrg. Az alapértelmezett érték https://login.microsoftonline.com/.

  • --client-id <ID>

    A projekt ügyfélazonosítója. Használjon , IndividualB2Cvagy SingleOrg hitelesítésselMultiOrg. Az alapértelmezett érték 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    A címtár-bérlő tartománya. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték qualified.domain.name.

  • --tenant-id <ID>

    Annak a könyvtárnak a TenantId azonosítója, amelyhez csatlakozni szeretne. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    A kérelem elérési útja az átirányítási URI alapútvonalán belül. Használjon vagy SingleOrg hitelesítésselIndividualB2C. Az alapértelmezett érték /signin-oidc.

  • -r|--org-read-access

    Lehetővé teszi, hogy az alkalmazás olvasási hozzáférést biztosítson a címtárhoz. Csak a hitelesítésre vagy SingleOrg a hitelesítésre MultiOrg vonatkozik.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • --no-https

    Kikapcsolja a HTTPS-t. Ez a beállítás csak akkor érvényes, ha Individual, IndividualB2Cvagy SingleOrgMultiOrgnincs használatban.

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre vagy Individual a hitelesítésre IndividualB2C vonatkozik.

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A .NET Core 3.0 SDK óta elérhető lehetőség.

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --use-browserlink

    Tartalmazza a BrowserLinket a projektben.

  • -rrc|--razor-runtime-compilation

    Meghatározza, hogy a projekt úgy van-e konfigurálva, hogy a Razor futtatókörnyezet fordítását használja-e hibakeresési buildekben.

  • --kestrelHttpPort

    A HTTP-végponthoz használandó portszám a launchSettings.json.

  • --kestrelHttpsPort

    A HTTPS-végponthoz launchSettings.json használandó portszám. Ez a beállítás nem alkalmazható a paraméter no-https használatakor (de no-https a rendszer figyelmen kívül hagyja, ha egyéni vagy szervezeti hitelesítési beállítást választ --auth).

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

angular, react

A .NET 8 SDK óta megszűnt.

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa.

    A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • Individual - Egyéni hitelesítés.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --no-https

    Kikapcsolja a HTTPS-t. Ez a beállítás csak akkor érvényes, ha a hitelesítés .None

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre vagy Individual a hitelesítésre IndividualB2C vonatkozik. A .NET Core 3.0 SDK óta érhető el.

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    Feljegyzés

    net8.0Ha azonban ASP.NET Core-nal szeretne React-alkalmazásokat fejleszteni, tekintse meg az egyoldalas alkalmazások (SLA-k) áttekintését ASP.NET Core-ban.

    SDK verziója Alapértelmezett érték
    7,0 net7.0

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --kestrelHttpPort

    A HTTP-végponthoz használandó portszám a launchSettings.json.

  • --kestrelHttpsPort

    A HTTPS-végponthoz launchSettings.json használandó portszám. Ez a beállítás nem alkalmazható a paraméter no-https használatakor (de no-https a rendszer figyelmen kívül hagyja, ha egyéni vagy szervezeti hitelesítési beállítást választ --auth).

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

razorclasslib

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

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

    Támogatja a hagyományos Razor-lapok és nézetek hozzáadását az összetevők mellett a tárhoz.

webapiaot

Webes API-projektet hoz létre az AOT-közzététel engedélyezésével. További információ: Natív AOT-üzembe helyezés és a Webes API (natív AOT) sablon.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert .

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Az alkalmazandó hitelesítés típusa. A lehetséges értékek a következők:

    • None - Nincs hitelesítés (alapértelmezett).
    • IndividualB2C - Egyéni hitelesítés az Azure AD B2C-vel.
    • SingleOrg - Szervezeti hitelesítés egyetlen bérlőhöz. Az Entra külső azonosító bérlői a SingleOrg-t is használják.
    • Windows - Windows-hitelesítés.

  • --aad-b2c-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory B2C-példány. Hitelesítéssel használható IndividualB2C . Az alapértelmezett érték https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Hozzon létre egy projektet, amely a minimális ASP.NET API-t használja. Az alapértelmezett beállítás, falsede ezt a beállítást felül kell bírálni -controllers. Mivel az alapértelmezett beállítás -controllersfalseaz, a bármelyik beállítás megadása nélkül történő beírás dotnet new webapi minimális API-projektet hoz létre.

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

    A projekt bejelentkezési és regisztrációs házirend-azonosítója. Hitelesítéssel használható IndividualB2C .

  • --aad-instance <INSTANCE>

    A csatlakozáshoz használt Azure Active Directory-példány. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték https://login.microsoftonline.com/.

  • --client-id <ID>

    A projekt ügyfélazonosítója. Használjon vagy IndividualB2C hitelesítésselSingleOrg. Az alapértelmezett érték 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    A vezérlők használata minimális API-k helyett. Ha ez a beállítás is -minimal meg van adva, ez a beállítás felülbírálja a megadott -minimalértéket. Az alapértelmezett szint a false. A .NET 8 SDK óta érhető el.

  • --domain <DOMAIN>

    A címtár-bérlő tartománya. Használjon vagy IndividualB2C hitelesítésselSingleOrg. Az alapértelmezett érték qualified.domain.name.

  • --tenant-id <ID>

    Annak a könyvtárnak a TenantId azonosítója, amelyhez csatlakozni szeretne. Hitelesítéssel használható SingleOrg . Az alapértelmezett érték 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Lehetővé teszi, hogy az alkalmazás olvasási hozzáférést biztosítson a címtárhoz. Csak a hitelesítésre SingleOrg vonatkozik.

  • --exclude-launch-settings

    Kizárja a launchSettings.json a létrehozott sablonból.

  • --no-openapi

    Kikapcsolja az OpenAPI (Swagger) támogatását. AddSwaggerGen, UseSwaggerés UseSwaggerUI nincs meghívva.

  • --no-https

    Kikapcsolja a HTTPS-t. A rendszer nem hoz létre https-indítási profilt.launchSettings.json app.UseHstsProgram.cs app.UseHttpsRedirection Startup.cs/. Ez a beállítás csak akkor érvényes, ha IndividualB2C hitelesítésre használják vagy SingleOrg nem használják.

  • -uld|--use-local-db

    Meghatározza, hogy a LocalDB-t az SQLite helyett kell használni. Csak a hitelesítésre IndividualB2C vonatkozik.

  • -f|--framework <FRAMEWORK>

    Megadja a megcélzandó keretrendszert . A beállítás nem érhető el a .NET Core 2.2 SDK-ban.

    Az alábbi táblázat a használt SDK-verziószámnak megfelelően sorolja fel az alapértelmezett értékeket:

    SDK verziója Alapértelmezett érték
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    Ha olyan projektet szeretne létrehozni, amely a használt SDK-nál korábbi keretrendszert céloz meg, tekintse meg --frameworkconsole a jelen cikk korábbi projektjeit.

  • --no-restore

    Nem hajt végre implicit visszaállítást a projekt létrehozása során.

  • --use-program-main

    Ha meg van adva, a rendszer explicit osztályt Program és Main metódust használ a legfelső szintű utasítások helyett. A .NET SDK 6.0.300 óta érhető el. Alapértelmezett érték: false.

apicontroller

API-vezérlő olvasási/írási műveletekkel vagy anélkül.

  • -p:n|--name <NAME>

    A létrehozott kód névtere. Az alapértelmezett szint a MyApp.Namespace.

  • -ac|--actions

    Vezérlő létrehozása olvasási/írási műveletekkel. Az alapértelmezett szint a false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    A .NET SDK global.json fájlban használandó verzióját adja meg.

  • --roll-forward <ROLL_FORWARD_POLICY>

    Az SDK-verzió kiválasztásakor használandó roll-forward szabályzat tartalékként, ha egy adott SDK-verzió hiányzik, vagy irányelvként egy későbbi verzió használatára. További információ: global-json.

editorconfig

Létrehoz egy .editorconfig fájlt a kódstílus-beállítások konfigurálásához.

  • --empty

    A .NET alapértelmezett beállításai helyett egy üres .editorconfigot hoz létre.

Lásd még