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 (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,則唯一可用的
--framework
net7.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 install
Microsoft.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#。
classlib
-f|--framework <FRAMEWORK>
指定要 設定目標的架構 。 值:
net7.0
、、net6.0
或netcoreapp3.1
建立 .NET 類別庫,或netstandard2.1
netstandard2.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
建立舊版 TFM 專案的能力取決於已安裝該版本的 SDK。 例如,如果您只安裝 .NET 6 SDK,則唯一可用的 --framework
net6.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,則唯一可用的 --framework
net6.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 實例。 搭配
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。 只有在 、
IndividualB2C
SingleOrg
、 或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
。
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
。
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
。
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
。
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
個別或組織驗證設定時會忽略此選項)。
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
。
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.UseHsts
app.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
。
globaljson
--sdk-version <VERSION_NUMBER>
指定要在 global.json 檔案中使用的 .NET SDK 版本。
editorconfig
建立 . editorconfig 檔案來設定程式碼樣式喜好設定。
--empty
建立空 的 .editorconfig ,而不是 .NET 的預設值。
另請參閱
.NET feedback
The .NET documentation is open source. Provide feedback here.
意見反應
提交並檢視相關的意見反應