dotnet new 的 .NET 預設範本

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

dotnet new list

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

下表顯示已停止且不再預安裝 .NET SDK 的範本。 按一下簡短名稱連結即可查看特定範本選項。

範本選項

各個範本可能還會有其他可用的選項。 若要顯示範本可用的其他選項，請使用 --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 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

  建立舊版 TFM 的專案的能力取決於已安裝該版本的 SDK。 例如，如果您只安裝 .NET 9 SDK，則唯一可用於 --framework 的值會 net9.0。 例如，如果您安裝 .NET 8 SDK，net8.0 的值就會變成可供 --framework使用。 因此，藉由指定 --framework net8.0，即使在 .NET 9 SDK 中執行 dotnet new 時，您也能以 .NET 8 為目標。

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

• --langVersion <VERSION_NUMBER>

  在建立的專案檔中設定 LangVersion 屬性。 例如，使用 --langVersion 7.3 可使用 C# 7.3。 不支援 F#。

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

• --no-restore

  若有指定，專案建立期間不執行隱含還原。

• --use-program-main

  若有指定，則會使用明確的 Program 類別和 Main 方法，而不是最上層陳述式。 自 .NET SDK 6.0.300 起提供使用。 預設值: false。 僅適用於 C#。

classlib

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。 值：net9.0、、 net8.0或 net7.0 建立 .NET 類別庫，或netstandard2.1netstandard2.0建立 .NET 標準類別庫。 .NET SDK 9.0.x 的預設值為 net9.0。

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

• --langVersion <VERSION_NUMBER>

  在建立的專案檔中設定 LangVersion 屬性。 例如，使用 --langVersion 7.3 可使用 C# 7.3。 不支援 F#。

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

• --no-restore

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

wpf、 、 wpflib、 wpfcustomcontrollibwpfusercontrollib

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。 針對 .NET 9 SDK，預設值為 net9.0。

• --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 9 SDK 的預設值為 net9.0。

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

• --exclude-launch-settings

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

• --no-restore

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

• --use-program-main

  若有指定，則會使用明確的 Program 類別和 Main 方法，而不是最上層陳述式。 自 .NET SDK 6.0.300 起提供使用。 預設值: false。

mstest

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

建立舊版 TFM 的專案的能力取決於已安裝該版本的 SDK。 例如，如果您只安裝 .NET 9 SDK，則唯一可用於 --framework 的值會 net9.0。 例如，如果您安裝 .NET 8 SDK，net8.0 的值就可供 --framework使用。 因此，藉由指定 --framework net8.0，即使在 .NET 9 SDK 中執行 dotnet new 時，您也能以 .NET 8 為目標。

• --no-restore

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

• --sdk

  使用 MSTest.Sdk 項目樣式。

• --test-runner <TEST_RUNNER>

  測試專案的執行器/平臺。 可能的值是：

  • VSTest - VSTest 平台 （預設值）。
  • MSTest - Microsoft.Testing.Platform。

• --coverage-tool <COVERAGE_TOOL>

  用於測試專案的涵蓋範圍工具。 可能的值是：

  • Microsoft.CodeCoverage - Microsoft程式代碼涵蓋範圍 （預設值）。
  • coverlet - 涵蓋範圍工具。

• --extensions-profile <EXTENSIONS_PROFILE>

  使用 Microsoft.Testing.Platform 時，SDK 擴充功能配置檔。 可能的值是：

  • Default - 預設延伸模組設定檔 （預設值）。
  • None - 不未啟用任何延伸模組。
  • AllMicrosoft - 啟用 Microsoft 隨附的所有延伸模組 (包括具有限制性授權的延伸模組)。

• --fixture <FIXTURE>

  要包含在測試專案中的裝置種類。 可能的值是：

  • None - 沒有裝置方法。
  • AssemblyInitialize - AssemblyInitialize 裝置方法。
  • AssemblyCleanup - AssemblyCleanup 裝置方法。
  • ClassInitialize - ClassInitialize 裝置方法。
  • ClassCleanup - ClassCleanup 裝置方法。
  • TestInitialize - TestInitialize 裝置方法。
  • TestCleanup - TestCleanup 裝置方法。

  允許多個值的位置。

• -p|--enable-pack

  使用 dotnet pack 封裝專案。

mstest-class

• --fixture <FIXTURE>

  要包含在測試專案中的裝置種類。 可能的值是：

  • None - 沒有裝置方法。
  • AssemblyInitialize - AssemblyInitialize 裝置方法。
  • AssemblyCleanup - AssemblyCleanup 裝置方法。
  • ClassInitialize - ClassInitialize 裝置方法。
  • ClassCleanup - ClassCleanup 裝置方法。
  • TestInitialize - TestInitialize 裝置方法。
  • TestCleanup - TestCleanup 裝置方法。

  允許多個值的位置。

xunit

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

建立舊版 TFM 的專案的能力取決於已安裝該版本的 SDK。 例如，如果您只安裝 .NET 9 SDK，則唯一可用於 --framework 的值會 net9.0。 例如，如果您安裝 .NET 8 SDK，net8.0 的值就可供 --framework使用。 因此，藉由指定 --framework net8.0，即使在 .NET 9 SDK 中執行 dotnet new 時，您也能以 .NET 8 為目標。

• -p|--enable-pack

  使用 dotnet pack 封裝專案。

• --no-restore

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

nunit

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

建立舊版 TFM 的專案的能力取決於已安裝該版本的 SDK。 例如，如果您只安裝 .NET 9 SDK，則唯一可用於 --framework 的值會 net9.0。 例如，如果您安裝 .NET 8 SDK，net8.0 的值就可供 --framework使用。 因此，藉由指定 --framework net8.0，即使在 .NET 9 SDK 中執行 dotnet new 時，您也能以 .NET 8 為目標。

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

自 .NET 8 SDK 起已停止。

• -au|--auth <AUTHENTICATION_TYPE>

  要使用的驗證類型。 可能的值是：

  • None - 無驗證 (預設值)。
  • Individual - 個別驗證。
  • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
  • SingleOrg - 單一租用戶的組織驗證。 Entra 外部 ID 租用戶也使用 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

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

• --no-https

  關閉 HTTPS。 此選項僅適用於未針對 Individual 使用 IndividualB2C、SingleOrg、MultiOrg 或 --auth 時。

• -uld|--use-local-db

  指定應該使用 LocalDB，不使用 SQLite。 僅適用於 Individual 或 IndividualB2C 驗證。

• --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。

blazor

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

  此範本適用於 .NET 8 或更新版本。

• --no-restore

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

• --exclude-launch-settings

  從產生的應用程式中排除 launchSettings.json。

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

  指定要為互動式元件使用的互動式轉譯模式。 可能的值是：

  • None - 無互動功能 (僅限靜態伺服器端轉譯)。
  • Server - (預設) 使用互動式伺服器端轉譯在伺服器上執行應用程式。
  • WebAssembly - 使用瀏覽器中的用戶端轉譯搭配 WebAssembly 執行應用程式。
  • Auto - 在下載 Blazor 套件組合並啟用 Blazor 用戶端上的執行階段時使用互動式伺服器端轉譯，然後搭配 WebAssembly 使用用戶端轉譯。

• --empty

  省略展示基本使用模式的範例頁面和樣式。

• -au|--auth <AUTHENTICATION_TYPE>

  要使用的驗證類型。 可能的值是：

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

• -uld|--use-local-db

  指定應該使用 LocalDB，不使用 SQLite。 僅適用於 Individual 驗證。

• -ai|--all-interactive

  藉由在最上層套用互動式轉譯模式，讓每個頁面都可互動。 如果為 false，則頁面預設會使用靜態伺服器端轉譯，而且可以在每頁或每個元件的基礎上標示為互動式。 只有在 -i|--interactivity 選項未設定為 None 時，此選項才有效。

• --no-https

  關閉 HTTPS。 這個選項只有在未將 Individual 選項選擇為 -au|--auth 時才適用。

• --use-program-main

  若有指定，則會產生明確的 Program 類別和 Main 方法，而不是最上層陳述式。

blazorwasm

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

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

• --no-restore

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

• -ho|--hosted

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

• -au|--auth <AUTHENTICATION_TYPE>

  要使用的驗證類型。 可能的值是：

  • None - 無驗證 (預設值)。
  • Individual - 個別驗證。
  • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
  • SingleOrg - 單一租用戶的組織驗證。 Entra 外部 ID 租用戶也使用 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

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

• -p|--pwa

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

• --no-https

  關閉 HTTPS。 此選項僅適用於未針對 Individual 使用 IndividualB2C、SingleOrg 或 --auth 時。

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

  用於 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 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

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

• --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 - 單一租用戶的組織驗證。 Entra 外部 ID 租用戶也使用 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

  從產生的範本中排除 launchSettings.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 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

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

• --no-restore

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

• --use-browserlink

  專案中包含 BrowserLink。

• -rrc|--razor-runtime-compilation

  判斷專案是否已設定為在偵錯組建中使用 Razor 執行時間編譯。

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

自 .NET 8 SDK 起已停止。

• -au|--auth <AUTHENTICATION_TYPE>

  要使用的驗證類型。

  可能的值是：

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

• --exclude-launch-settings

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

• --no-restore

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

• --no-https

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

• -uld|--use-local-db

  指定應該使用 LocalDB，不使用 SQLite。 僅適用於 Individual 或 IndividualB2C 驗證。 自 .NET Core 3.0 SDK 起提供使用。

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  注意

  沒有適用於 net8.0 的 React 範本，不過，如果您有興趣使用 ASP.NET Core 開發 React 應用程式，請參閱 ASP.NET Core 中的單頁應用程式 (SPA) 概觀 (部分機器翻譯)。

  SDK 版本	預設值
  7.0	net7.0

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

• --kestrelHttpPort

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

• --kestrelHttpsPort

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

• --use-program-main

  若有指定，則會使用明確的 Program 類別和 Main 方法，而不是最上層陳述式。 自 .NET SDK 6.0.300 起提供使用。 預設值: false。

razorclasslib

• --no-restore

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

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

  除了元件之外，支援將傳統 Razor 頁面及檢視新增至此程式庫。

webapiaot

使用已啟用 AOT 發佈的 Web API 專案。 如需詳細資訊，請參閱原生 AOT 部署 (英文) 和 Web API (原生 AOT) 範本 (部分機器翻譯)。

• --exclude-launch-settings

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

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0

• --no-restore

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

• --use-program-main

  若有指定，則會使用明確的 Program 類別和 Main 方法，而不是最上層陳述式。 自 .NET SDK 6.0.300 起提供使用。 預設值: false。

webapi

• -au|--auth <AUTHENTICATION_TYPE>

  要使用的驗證類型。 可能的值是：

  • None - 無驗證 (預設值)。
  • IndividualB2C - 使用 Azure AD B2C 的個別驗證。
  • SingleOrg - 單一租用戶的組織驗證。 Entra 外部 ID 租用戶也使用 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。 自 .NET 8 SDK 起提供。

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

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

• --no-openapi

  關閉 OpenAPI (Swagger) 支援。 不會呼叫 AddSwaggerGen、UseSwagger 和 UseSwaggerUI。

• --no-https

  關閉 HTTPS。 不會在 中建立 launchSettings.json 啟動設定檔。 不會在 app.UseHstsapp.UseHttpsRedirectionStartup.cs 中呼叫 / 和 。 此選項僅適用於未針對驗證使用 IndividualB2C 或 SingleOrg 時。

• -uld|--use-local-db

  指定應該使用 LocalDB，不使用 SQLite。 僅適用於 IndividualB2C 驗證。

• -f|--framework <FRAMEWORK>

  指定要當成目標的架構。 .NET Core 2.2 SDK 中沒有提供的選項。

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

  SDK 版本	預設值
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

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

• --no-restore

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

• --use-program-main

  若有指定，則會使用明確的 Program 類別和 Main 方法，而不是最上層陳述式。 自 .NET SDK 6.0.300 起提供使用。 預設值: false。

apicontroller

具有或不含讀取/寫入動作的 API 控制器。

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

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

• -ac|--actions

  建立具有讀取/寫入動作的控制器。 預設值為 false。

globaljson

• --sdk-version <VERSION_NUMBER>

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

• --roll-forward <ROLL_FORWARD_POLICY>

  選取 SDK 版本時要使用的向前復原原則，可能是當特定 SDK 版本遺失時作為後援，或是作為使用較新版本的指示詞。 如需詳細資訊，請參閱 global-json。

editorconfig

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

• --empty

  建立空白的 .editorconfig，而非 .NET 的預設值。

另請參閱

• dotnet new 命令
• dotnet new list 命令
• dotnet new 的自訂範本
• 建立適用於 dotnet new 的自訂範本
• 隱含 using 指示詞