dotnet new 的 .NET 預設範本

發行項
09/12/2023

當您安裝 .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 （VB 為 5.0）
WPF 類別庫	`wpflib`	[C#]， VB	一般/WPF	3.0 （VB 為 5.0）
WPF 自訂控制項程式庫	`wpfcustomcontrollib`	[C#]， VB	一般/WPF	3.0 （VB 為 5.0）
WPF 使用者控制程式庫	`wpfusercontrollib`	[C#]， VB	一般/WPF	3.0 （VB 為 5.0）
Windows Forms （WinForms）應用程式	`winforms`	[C#]， VB	Common/WinForms	3.0 （VB 為 5.0）
Windows Forms （WinForms）類別庫	`winformslib`	[C#]， VB	Common/WinForms	3.0 （VB 為 5.0）
背景工作服務	`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/Web API/API/Service/WebAPI	1.0
ASP.NET 核心 API	`webapiaot`	[C#]	Web/Web API/API/Service	8.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 就會變成可用等等。因此，指定 --framework netcoreapp3.1 即使在 .NET 6 SDK 中執行 dotnet new 時，您也可以將目標設為 .NET Core 3.1。

或者，若要建立以您所使用的 SDK 早于架構為目標的專案，您可以安裝範本的 NuGet 套件來執行此動作。一般、 Web 和 SPA 專案類型會針對每個目標架構 Moniker 使用不同的套件（TFM）。例如，若要建立 console 以為目標 netcoreapp1.0 的專案，請在上執行 dotnet new installMicrosoft.DotNet.Common.ProjectTemplates.1.x 。
--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#。

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

`classlib`

-f|--framework <FRAMEWORK>

指定要設定目標的架構。值： net7.0 、、 net6.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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--exclude-launch-settings

從 產生的範本排除 launch設定.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

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

SDK 版本	預設值
6.0	`net6.0`
5.0	`net5.0`
3.1	`netcoreapp3.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 實例。搭配 SingleOrg 或 MultiOrg 驗證使用。預設值是 https://login.microsoftonline.com/。
--client-id <ID>

此專案的用戶端識別碼。搭配 IndividualB2C、SingleOrg 或 MultiOrg 驗證使用。預設值是 11111111-1111-1111-11111111111111111。
--domain <DOMAIN>

目錄租使用者的網域。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 qualified.domain.name。
--tenant-id <ID>

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

重新導向 URI 的應用程式基底路徑內的要求路徑。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 /signin-oidc。
-r|--org-read-access

允許此應用程式讀取目錄的存取權。僅適用於 SingleOrg 或 MultiOrg 驗證。
--exclude-launch-settings

從 產生的範本排除 launch設定.json 。
--no-https

關閉 HTTPS。只有在、 IndividualB2CSingleOrg 、或 MultiOrg 未用於 --auth 時 Individual ，才適用此選項。
-uld|--use-local-db

指定應該使用 LocalDB，而不是 SQLite。僅適用於 Individual 或 IndividualB2C 驗證。
--no-restore

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

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--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>

此專案的用戶端識別碼。在獨立案例中搭配 IndividualB2C 、 SingleOrg 或 Individual 驗證使用。預設值是 33333333-3333-3333-33333333333333333。
--domain <DOMAIN>

目錄租使用者的網域。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 qualified.domain.name。
--app-id-uri <URI>

您想要呼叫之伺服器 API 的應用程式識別碼 URI。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 api.id.uri。
--api-client-id <ID>

伺服器裝載之 API 的用戶端識別碼。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 11111111-1111-1111-11111111111111111。
-s|--default-scope <SCOPE>

用戶端要求布建存取權杖的 API 範圍。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 user_impersonation。
--tenant-id <ID>

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

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

從 產生的範本排除 launch設定.json 。
-p|--pwa

會產生支援安裝和離線使用的漸進式 Web 應用程式（PWA）。
--no-https

關閉 HTTPS。只有在、 IndividualB2C 或 SingleOrg 未用於 --auth 時 Individual ，才適用此選項。
-uld|--use-local-db

指定應該使用 LocalDB，而不是 SQLite。僅適用於 Individual 或 IndividualB2C 驗證。
--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

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 no-https 時，此選項不適用（但在 no-https 選擇 --auth 個別或組織驗證設定時會忽略此選項）。
--use-program-main

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

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

`web`

--exclude-launch-settings

從 產生的範本排除 launch設定.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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--no-restore

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

關閉 HTTPS。
--kestrelHttpPort

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 no-https 時，此選項不適用（但在 no-https 選擇 --auth 個別或組織驗證設定時會忽略此選項）。
--use-program-main

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

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

`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 實例。搭配 SingleOrg 或 MultiOrg 驗證使用。預設值是 https://login.microsoftonline.com/。
--client-id <ID>

此專案的用戶端識別碼。搭配 IndividualB2C、SingleOrg 或 MultiOrg 驗證使用。預設值是 11111111-1111-1111-11111111111111111。
--domain <DOMAIN>

目錄租使用者的網域。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 qualified.domain.name。
--tenant-id <ID>

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

重新導向 URI 的應用程式基底路徑內的要求路徑。搭配 SingleOrg 或 IndividualB2C 驗證使用。預設值是 /signin-oidc。
-r|--org-read-access

允許此應用程式讀取目錄的存取權。僅適用於 SingleOrg 或 MultiOrg 驗證。
--exclude-launch-settings

從 產生的範本排除 launch設定.json 。
--no-https

關閉 HTTPS。此選項僅適用於未使用 Individual、IndividualB2C、SingleOrg 或 MultiOrg 時。
-uld|--use-local-db

指定應該使用 LocalDB，而不是 SQLite。僅適用於 Individual 或 IndividualB2C 驗證。
-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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--no-restore

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

在專案中包含 BrowserLink。 .NET Core 2.2 和 3.1 SDK 中無法使用的選項。
-rrc|--razor-runtime-compilation

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

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 no-https 時，此選項不適用（但在 no-https 選擇 --auth 個別或組織驗證設定時會忽略此選項）。
--use-program-main

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

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

`angular`, `react`

-au|--auth <AUTHENTICATION_TYPE>

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

可能的值是：
- None - 無驗證 (預設值)。
- Individual - 個別驗證。
--exclude-launch-settings

從 產生的範本排除 launch設定.json 。
--no-restore

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

關閉 HTTPS。只有在驗證為 None 時才適用此選項。
-uld|--use-local-db

指定應該使用 LocalDB，而不是 SQLite。僅適用於 Individual 或 IndividualB2C 驗證。自 .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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--kestrelHttpPort

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 no-https 時，此選項不適用（但在 no-https 選擇 --auth 個別或組織驗證設定時會忽略此選項）。
--use-program-main

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

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

`reactredux`

--exclude-launch-settings

從 產生的範本排除 launch設定.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 早于架構為目標的專案，請參閱 --framework 本文稍早的專案 console 。
--no-restore

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

關閉 HTTPS。
--kestrelHttpPort

要用於 launch 中 HTTP 端點 的埠號碼設定.json 。
--kestrelHttpsPort

要用於 launch 中 HTTPS 端點 的埠號碼設定.json 。使用參數 no-https 時，此選項不適用（但在 no-https 選擇 --auth 個別或組織驗證設定時會忽略此選項）。

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

`razorclasslib`

--no-restore

不會在專案建立期間執行隱含還原。
-s|--support-pages-and-views

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

`webapiaot`

建立已啟用 AOT 發行的 Web API 專案。如需詳細資訊，請參閱原生 AOT 部署和 Web API （原生 AOT）範本。

--exclude-launch-settings

從 產生的範本排除 launch設定.json 。
-f|--framework <FRAMEWORK>

指定要設定目標的架構。

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

SDK 版本預設值

8.0 net8.0
--no-restore

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

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

SDK 版本	預設值
8.0	`net8.0`

`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 的專案。預設值為 false ，但此選項會由 --controllers 覆寫。由於的預設值 --controllers 為 false ，因此輸入 dotnet new webapi 而不指定任一選項會建立最小的 API 專案。
-ssp|--susi-policy-id <ID>

此專案的登入和註冊原則識別碼。搭配 IndividualB2C 驗證使用。
--aad-instance <INSTANCE>

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

此專案的用戶端識別碼。搭配 IndividualB2C 或 SingleOrg 驗證使用。預設值是 11111111-1111-1111-11111111111111111。
--controllers, --use-controllers

是否要使用控制器，而不是最少的 API。如果同時指定此選項和 -minimal ，這個選項會覆寫所 -minimal 指定的值。預設值為 false。
--domain <DOMAIN>

目錄租使用者的網域。搭配 IndividualB2C 或 SingleOrg 驗證使用。預設值是 qualified.domain.name。
--tenant-id <ID>

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

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

從 產生的範本排除 launch設定.json 。
--no-openapi

關閉 OpenAPI （Swagger）支援。 AddSwaggerGen、 UseSwagger 、和 UseSwaggerUI 未呼叫。
--no-https

關閉 HTTPS。不會 在中 launchSettings.json 建立 HTTPs 啟動設定檔。 app.UseHstsapp.UseHttpsRedirection和不會在 Program.cs / Startup.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。

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`

`globaljson`

--sdk-version <VERSION_NUMBER>

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

`editorconfig`

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

--empty

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

dotnet new 的 .NET 預設範本

範本選項

`console`

`classlib`

`wpf`, `wpflib`, `wpfcustomcontrollib`, `wpfusercontrollib`

`winforms`, `winformslib`

`worker`, `grpc`

`mstest`, `xunit`

`nunit`

`page`

`viewimports`, `proto`

`blazorserver`

`blazorwasm`

`web`

`mvc`, `webapp`

`angular`, `react`

`reactredux`

`razorclasslib`

`webapiaot`

`webapi`

`globaljson`

`editorconfig`

另請參閱

意見反應

其他資源

其他資源

dotnet new 的 .NET 預設範本

範本選項

console

classlib

wpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

winforms, winformslib

worker, grpc

mstest, xunit

nunit

page

viewimports, proto

blazorserver

blazorwasm

web

mvc, webapp

angular, react

reactredux

razorclasslib

webapiaot

webapi

globaljson

editorconfig

另請參閱

意見反應

其他資源

其他資源

`console`

`classlib`

`wpf`, `wpflib`, `wpfcustomcontrollib`, `wpfusercontrollib`

`winforms`, `winformslib`

`worker`, `grpc`

`mstest`, `xunit`

`nunit`

`page`

`viewimports`, `proto`

`blazorserver`

`blazorwasm`

`web`

`mvc`, `webapp`

`angular`, `react`

`reactredux`

`razorclasslib`

`webapiaot`

`webapi`

`globaljson`

`editorconfig`