dotnet new 的 .NET 預設範本

當您安裝.NET SDK時,您會收到數十個用來建立專案和檔案的內建範本,包括主控台應用程式、類別庫、單元測試專案、ASP.NET Core應用程式 (,包括Angular和React專案) 和組態檔。 若要列出內建範本,請執行 dotnet new list 命令:

dotnet new list

下表顯示預先安裝 .NET SDK 的範本。 範本的預設語言會顯示在方括號內。 按一下簡短名稱連結以查看特定的範本選項。

範本 簡短名稱 語言 標籤 推出的版本
主控台應用程式 console [C#], F#, VB 通用/主控台 1.0
類別庫 classlib [C#], F#, VB 通用/程式庫 1.0
WPF 應用程式 wpf [C#], VB 一般/WPF 3.0 (5.0 for VB)
WPF 類別庫 wpflib [C#], VB 一般/WPF 3.0 (5.0 for VB)
WPF 自訂控制項程式庫 wpfcustomcontrollib [C#], VB 一般/WPF 3.0 (5.0 for VB)
WPF 使用者控制項程式庫 wpfusercontrollib [C#], VB 一般/WPF 3.0 (5.0 for VB)
Windows Forms (WinForms) 應用程式 winforms [C#], VB Common/WinForms 3.0 (5.0 for VB)
Windows Forms (WinForms) 類別庫 winformslib [C#], VB Common/WinForms 3.0 (5.0 for VB)
背景工作服務 worker [C#] 一般/背景工作/Web 3.0
單元測試專案 mstest [C#], F#, VB 測試/MSTest 1.0
NUnit 3 測試專案 nunit [C#], F#, VB 測試/NUnit 2.1.400
NUnit 3 測試項目 nunit-test [C#], F#, VB 測試/NUnit 2.2
xUnit 測試專案 xunit [C#], F#, VB 測試/XUnit 1.0
Razor 元件 razorcomponent [C#] Web/ASP.NET 3.0
Razor 頁面 page [C#] Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0
Blazor 伺服器應用程式 blazorserver [C#] Web/Blazor 3.0
Blazor 伺服器應用程式空白 blazorserver-empty [C#] Web/Blazor 7.0
BlazorWebAssembly 應用程式 blazorwasm [C#] Web/ Blazor /WebAssembly 3.1.300
BlazorWebAssembly 應用程式空白 blazorwasm-empty [C#] Web/ Blazor /WebAssembly 7.0
空的 ASP.NET Core web [C#]、F# Web/空白 1.0
ASP.NET Core Web 應用程式 (模型檢視控制器) mvc [C#]、F# Web/MVC 1.0
ASP.NET Core Web 應用程式 webapp, razor [C#] Web/MVC/Razor 頁面 2.2, 2.0
ASP.NET Core 與 Angular angular [C#] Web/MVC/SPA 2.0
ASP.NET Core 與 React.js react [C#] Web/MVC/SPA 2.0
Razor 類別庫 razorclasslib [C#] Web/Razor/程式庫/Razor 類別庫 2.1
ASP.NET Core Web API webapi [C#]、F# Web/WebAPI 1.0
ASP.NET Core gRPC 服務 grpc [C#] Web/gRPC 3.0
dotnet gitignore 檔案 gitignore Config 3.0
global.json 檔案 globaljson Config 2.0
NuGet 組態 nugetconfig Config 1.0
Dotnet 本機工具資訊清單檔 tool-manifest Config 3.0
Web 組態 webconfig Config 1.0
方案檔 sln 解決方法 1.0
通訊協定緩衝區檔案 proto Web/gRPC 3.0
EditorConfig 檔案 editorconfig (#editorconfig) Config 6.0

範本選項

每個範本可能都有其他可用選項。 若要顯示範本可用的其他選項, --help 請使用選項搭配範本名稱引數,例如: dotnet new console --help 。 如果範本支援多種語言,此命令將會以預設語言顯示範本的說明。 藉由將其與 --language 選項結合,您可以看到其他語言的說明: dotnet new console --help --language F# 。 隨附于 .NET SDK 的範本有下列其他選項:

console

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 自 .NET Core 3.0 SDK 起提供。

    下表會根據您使用的 SDK 版本列出預設值:

    SDK 版本 預設值
    7.0 net7.0
    6.0 net6.0
    3.1 netcoreapp3.1

    建立舊版 TFM 的專案的能力取決於已安裝該版本的 SDK。 例如,如果您只安裝 .NET 7 SDK,則唯一可用的 --frameworknet7.0 值為 。 如果您安裝 .NET 6 SDK,值 net6.0 就會變成可供 使用 --framework 。 如果您安裝 .NET Core 3.1 SDK, netcoreapp3.1 就會變成可用等等。 因此,指定即使在 .NET 6 SDK 中執行 dotnet new 時,您也可以以 --framework netcoreapp3.1 .NET Core 3.1 為目標。

    或者,若要建立以您先前使用的 SDK 為目標之架構的專案,您可以安裝範本的 NuGet 套件來執行此動作。 一般WebSPA 專案類型會針對每個目標架構 Moniker (TFM) 使用不同的套件。 例如,若要建立 console 以 為目標的專案,請在 上執行 dotnet new installMicrosoft.DotNet.Common.ProjectTemplates.1.xnetcoreapp1.0

  • --langVersion <VERSION_NUMBER>

    LangVersion設定所建立專案檔中的 屬性。 例如,使用 --langVersion 7.3 可使用 C# 7.3。 不支援 F#。 自 .NET Core 2.2 SDK 起提供。

    如需預設 C# 版本的清單,請參閱 預設值

  • --no-restore

    如果指定,則不會在專案建立期間執行隱含還原。 自 .NET Core 2.2 SDK 起提供。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起提供。 預設值:false。 僅適用于 C#。


classlib

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 值: net7.0net6.0 、 或 netcoreapp3.1 建立 .NET 類別庫,或 netstandard2.1netstandard2.0 建立 .NET 標準類別庫。 .NET SDK 7.0.x 的預設值為 net7.0

    若要建立目標為早于您所使用的 SDK 之架構的專案,請參閱--framework 本文稍早的專案 console

  • --langVersion <VERSION_NUMBER>

    LangVersion設定所建立專案檔中的 屬性。 例如,使用 --langVersion 7.3 可使用 C# 7.3。 不支援 F#。 自 .NET Core 2.2 SDK 起提供。

    如需預設 C# 版本的清單,請參閱 預設值

  • --no-restore

    不會在專案建立期間執行隱含還原。


wpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 針對 .NET 6 SDK,預設值為 net6.0 。 自 .NET Core 3.1 SDK 起提供。

  • --langVersion <VERSION_NUMBER>

    LangVersion設定所建立專案檔中的 屬性。 例如,使用 --langVersion 7.3 可使用 C# 7.3。

    如需預設 C# 版本的清單,請參閱 預設值

  • --no-restore

    不會在專案建立期間執行隱含還原。


winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    LangVersion設定所建立專案檔中的 屬性。 例如,使用 --langVersion 7.3 可使用 C# 7.3。

    如需預設 C# 版本的清單,請參閱 預設值

  • --no-restore

    不會在專案建立期間執行隱含還原。


worker, grpc

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 .NET 7 SDK 的預設值為 net7.0 。 自 .NET Core 3.1 SDK 起提供。

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


mstest, xunit

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 自 .NET Core 3.0 SDK 起可用的選項。

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

為舊版 TFM 建立專案的能力取決於已安裝該版本的 SDK。 例如,如果您只安裝 .NET 6 SDK,則唯一可用的 --frameworknet6.0 值為 。 如果您安裝 .NET 5 SDK,值 net5.0 會變成可供 使用 --framework 。 如果您安裝 .NET Core 3.1 SDK, netcoreapp3.1 則會變成可用等等。 因此, --framework netcoreapp3.1 指定即使在 .NET 6 SDK 中執行 dotnet new 時,您也可以將目標設為 .NET Core 3.1。

  • -p|--enable-pack

    使用 dotnet pack啟用專案的封裝。

  • --no-restore

    不會在專案建立期間執行隱含還原。


nunit

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

為舊版 TFM 建立專案的能力取決於已安裝該版本的 SDK。 例如,如果您只安裝 .NET 6 SDK,則唯一可用的 --frameworknet6.0 值為 。 如果您安裝 .NET 5 SDK,值 net5.0 會變成可供 使用 --framework 。 如果您安裝 .NET Core 3.1 SDK, netcoreapp3.1 則會變成可用等等。 因此, --framework netcoreapp3.1 指定即使在 .NET 6 SDK 中執行 dotnet new 時,您也可以將目標設為 .NET Core 3.1。

  • -p|--enable-pack

    使用 dotnet pack啟用專案的封裝。

  • --no-restore

    不會在專案建立期間執行隱含還原。


page

  • -na|--namespace <NAMESPACE_NAME>

    所產生程式碼的命名空間。 預設值是 MyApp.Namespace

  • -np|--no-pagemodel

    建立沒有 PageModel 的頁面。


viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    所產生程式碼的命名空間。 預設值是 MyApp.Namespace


blazorserver

  • -au|--auth <AUTHENTICATION_TYPE>

    要使用的驗證類型。 可能的值包括:

    • None - 無驗證 (預設值)。
    • Individual - 個別驗證。
    • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
    • SingleOrg - 單一租用戶的組織驗證。
    • MultiOrg - 多個租用戶的組織驗證。
    • Windows - Windows 驗證。
  • --aad-b2c-instance <INSTANCE>

    要連線的 Azure Active Directory B2C 實例。 搭配 IndividualB2C 驗證使用。 預設值是 https://login.microsoftonline.com/tfp/

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

    此專案的登入和註冊原則識別碼。 搭配 IndividualB2C 驗證使用。

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

    此專案的重設密碼原則識別碼。 搭配 IndividualB2C 驗證使用。

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

    此專案的編輯設定檔原則識別碼。 搭配 IndividualB2C 驗證使用。

  • --aad-instance <INSTANCE>

    要連線的 Azure Active Directory 實例。 搭配 SingleOrgMultiOrg 驗證使用。 預設值是 https://login.microsoftonline.com/

  • --client-id <ID>

    此專案的用戶端識別碼。 搭配 IndividualB2CSingleOrgMultiOrg 驗證使用。 預設值是 11111111-1111-1111-11111111111111111

  • --domain <DOMAIN>

    目錄租使用者的網域。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 qualified.domain.name

  • --tenant-id <ID>

    要連線之目錄的 TenantId 識別碼。 搭配 SingleOrg 驗證使用。 預設值是 22222222-2222-2222-2222-222222222222

  • --callback-path <PATH>

    重新導向 URI 之應用程式基底路徑內的要求路徑。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 /signin-oidc

  • -r|--org-read-access

    允許此應用程式讀取目錄的存取權。 僅適用於 SingleOrgMultiOrg 驗證。

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • --no-https

    關閉 HTTPS。 只有在 、 IndividualB2CSingleOrgMultiOrg 未用於 --authIndividual ,才適用此選項。

  • -uld|--use-local-db

    指定應該使用 LocalDB,而不是 SQLite。 僅適用於 IndividualIndividualB2C 驗證。

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


blazorwasm

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • -ho|--hosted

    包含應用程式的 ASP.NET Core主機 BlazorWebAssembly 。

  • -au|--auth <AUTHENTICATION_TYPE>

    要使用的驗證類型。 可能的值包括:

    • None - 無驗證 (預設值)。
    • Individual - 個別驗證。
    • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
    • SingleOrg - 單一租用戶的組織驗證。
  • --authority <AUTHORITY>

    OIDC 提供者的授權單位。 搭配 Individual 驗證使用。 預設值是 https://login.microsoftonline.com/

  • --aad-b2c-instance <INSTANCE>

    要連線的 Azure Active Directory B2C 實例。 搭配 IndividualB2C 驗證使用。 預設值是 https://aadB2CInstance.b2clogin.com/

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

    此專案的登入和註冊原則識別碼。 搭配 IndividualB2C 驗證使用。

  • --aad-instance <INSTANCE>

    要連線的 Azure Active Directory 實例。 搭配 SingleOrg 驗證使用。 預設值是 https://login.microsoftonline.com/

  • --client-id <ID>

    此專案的用戶端識別碼。 在獨立案例中搭配 IndividualB2CSingleOrgIndividual 驗證使用。 預設值是 33333333-3333-3333-33333333333333333

  • --domain <DOMAIN>

    目錄租使用者的網域。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 qualified.domain.name

  • --app-id-uri <URI>

    您想要呼叫之伺服器 API 的應用程式識別碼 URI。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 api.id.uri

  • --api-client-id <ID>

    伺服器所裝載之 API 的用戶端識別碼。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 11111111-1111-1111-11111111111111111

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

    用戶端要求布建存取權杖所需的 API 範圍。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 user_impersonation

  • --tenant-id <ID>

    要連線之目錄的 TenantId 識別碼。 搭配 SingleOrg 驗證使用。 預設值是 22222222-2222-2222-2222-222222222222

  • -r|--org-read-access

    允許此應用程式讀取目錄的存取權。 SingleOrg僅適用于驗證。

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • -p|--pwa

    會產生支援安裝和離線使用的漸進式 Web 應用程式 (PWA) 。

  • --no-https

    關閉 HTTPS。 只有在 、 IndividualB2CSingleOrg 未用於 --authIndividual ,才適用此選項。

  • -uld|--use-local-db

    指定應該使用 LocalDB,而不是 SQLite。 僅適用於 IndividualIndividualB2C 驗證。

  • --called-api-url <URL>

    要從 Web 應用程式呼叫的 API URL。 SingleOrg僅適用于 或 IndividualB2C 驗證,但未指定 ASP.NET Core主機。 預設值是 https://graph.microsoft.com/v1.0/me

  • --calls-graph

    指定 Web 應用程式是否呼叫 Microsoft Graph。 SingleOrg僅適用于驗證。

  • --called-api-scopes <SCOPES>

    要求從 Web 應用程式呼叫 API 的範圍。 SingleOrg僅適用于 或 IndividualB2C 驗證,但未指定 ASP.NET Core主機。 預設值為 user.read

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


web

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 .NET Core 2.2 SDK 中無法使用選項。

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --no-https

    關閉 HTTPS。

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    要使用的驗證類型。 可能的值包括:

    • None - 無驗證 (預設值)。
    • Individual - 個別驗證。
    • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
    • SingleOrg - 單一租用戶的組織驗證。
    • MultiOrg - 多個租用戶的組織驗證。
    • Windows - Windows 驗證。
  • --aad-b2c-instance <INSTANCE>

    要連線的 Azure Active Directory B2C 實例。 搭配 IndividualB2C 驗證使用。 預設值是 https://login.microsoftonline.com/tfp/

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

    此專案的登入和註冊原則識別碼。 搭配 IndividualB2C 驗證使用。

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

    此專案的重設密碼原則識別碼。 搭配 IndividualB2C 驗證使用。

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

    此專案的編輯設定檔原則識別碼。 搭配 IndividualB2C 驗證使用。

  • --aad-instance <INSTANCE>

    要連線的 Azure Active Directory 實例。 搭配 SingleOrgMultiOrg 驗證使用。 預設值是 https://login.microsoftonline.com/

  • --client-id <ID>

    此專案的用戶端識別碼。 搭配 IndividualB2CSingleOrgMultiOrg 驗證使用。 預設值是 11111111-1111-1111-11111111111111111

  • --domain <DOMAIN>

    目錄租使用者的網域。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 qualified.domain.name

  • --tenant-id <ID>

    要連線之目錄的 TenantId 識別碼。 搭配 SingleOrg 驗證使用。 預設值是 22222222-2222-2222-2222-222222222222

  • --callback-path <PATH>

    重新導向 URI 之應用程式基底路徑內的要求路徑。 搭配 SingleOrgIndividualB2C 驗證使用。 預設值是 /signin-oidc

  • -r|--org-read-access

    允許此應用程式讀取目錄的存取權。 僅適用於 SingleOrgMultiOrg 驗證。

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • --no-https

    關閉 HTTPS。 此選項僅適用於未使用 IndividualIndividualB2CSingleOrgMultiOrg 時。

  • -uld|--use-local-db

    指定應該使用 LocalDB,而不是 SQLite。 僅適用於 IndividualIndividualB2C 驗證。

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 自 .NET Core 3.0 SDK 起可用的選項。

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --use-browserlink

    在專案中包含 BrowserLink。 .NET Core 2.2 和 3.1 SDK 中無法使用選項。

  • -rrc|--razor-runtime-compilation

    判斷專案是否已設定為在偵錯組建中使用 Razor 執行時間編譯 。 自 .NET Core 3.1.201 SDK 起可用的選項。

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


angular, react

  • -au|--auth <AUTHENTICATION_TYPE>

    要使用的驗證類型。 自 .NET Core 3.0 SDK 起提供。

    可能的值包括:

    • None - 無驗證 (預設值)。
    • Individual - 個別驗證。
  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --no-https

    關閉 HTTPS。 只有在驗證為 None 時,才適用此選項。

  • -uld|--use-local-db

    指定應該使用 LocalDB,而不是 SQLite。 僅適用於 IndividualIndividualB2C 驗證。 自 .NET Core 3.0 SDK 起提供。

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 .NET Core 2.2 SDK 中無法使用選項。

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.0

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起可用。 預設值:false


reactredux

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 .NET Core 2.2 SDK 中無法使用選項。

    下表根據您所使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.0

    若要建立目標為早于所使用 SDK 之架構的專案,請參閱 --frameworkconsole 本文稍早的專案。

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --no-https

    關閉 HTTPS。

  • --kestrelHttpPort

    要用於 launchSettings.json中 HTTP 端點的埠號碼。

  • --kestrelHttpsPort

    用於 launchSettings.json中 HTTPS 端點的埠號碼。 使用 參數 no-https (時不適用此選項,但在 no-https 為) 選擇 --auth 個人或組織驗證設定時會忽略此選項。


razorclasslib

  • --no-restore

    不會在專案建立期間執行隱含還原。

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

    除了此程式庫的元件之外,還支援新增傳統的 Razor 頁面和檢視。 自 .NET Core 3.0 SDK 起提供。


webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    要使用的驗證類型。 可能的值包括:

    • None - 無驗證 (預設值)。
    • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
    • SingleOrg - 單一租用戶的組織驗證。
    • Windows - Windows 驗證。
  • --aad-b2c-instance <INSTANCE>

    要連線的 Azure Active Directory B2C 實例。 搭配 IndividualB2C 驗證使用。 預設值是 https://login.microsoftonline.com/tfp/

  • -minimal|--use-minimal-apis

    建立使用ASP.NET Core最小 API的專案。

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

    此專案的登入和註冊原則識別碼。 搭配 IndividualB2C 驗證使用。

  • --aad-instance <INSTANCE>

    要連線的 Azure Active Directory 實例。 搭配 SingleOrg 驗證使用。 預設值是 https://login.microsoftonline.com/

  • --client-id <ID>

    此專案的用戶端識別碼。 搭配 IndividualB2CSingleOrg 驗證使用。 預設值是 11111111-1111-1111-11111111111111111

  • --domain <DOMAIN>

    目錄租使用者的網域。 搭配 IndividualB2CSingleOrg 驗證使用。 預設值是 qualified.domain.name

  • --tenant-id <ID>

    要連線之目錄的 TenantId 識別碼。 搭配 SingleOrg 驗證使用。 預設值是 22222222-2222-2222-2222-222222222222

  • -r|--org-read-access

    允許此應用程式讀取目錄的存取權。 SingleOrg僅適用于驗證。

  • --exclude-launch-settings

    從產生的範本中排除 launchSettings.json

  • --no-openapi

    關閉 OpenAPI (Swagger) 支援。 AddSwaggerGen不會呼叫 、 UseSwaggerUseSwaggerUI

  • --no-https

    關閉 HTTPS。 不會在 中 launchSettings.json 建立HTTPs啟動設定檔。 app.UseHstsapp.UseHttpsRedirection和 不會在Program.csStartup.cs/ 中呼叫。 只有在 或 SingleOrg 未用於驗證時 IndividualB2C ,才適用此選項。

  • -uld|--use-local-db

    指定應該使用 LocalDB,而不是 SQLite。 IndividualB2C僅適用于驗證。

  • -f|--framework <FRAMEWORK>

    指定要設為目標的 架構 。 .NET Core 2.2 SDK 中無法使用的選項。

    下表會根據您使用的 SDK 版本號碼列出預設值:

    SDK 版本 預設值
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    若要建立目標為早于您所使用的 SDK 之架構的專案,請參閱--framework 本文稍早的專案 console

  • --no-restore

    不會在專案建立期間執行隱含還原。

  • --use-program-main

    如果指定,則會使用明確的 Program 類別和 Main 方法,而不是最上層語句。 自 .NET SDK 6.0.300 起提供。 預設值:false


globaljson

  • --sdk-version <VERSION_NUMBER>

    指定要在 global.json 檔案中使用的 .NET SDK 版本。

editorconfig

建立 .editorconfig 檔案,以設定程式碼樣式喜好設定。

  • --empty

    建立空的 .editorconfig ,而不是 .NET 的預設值。

另請參閱