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,則唯一可用的 --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#。


classlib

  • -f|--framework <FRAMEWORK>

    指定要 設定目標的架構 。 值: net7.0 、、 net6.0netcoreapp3.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

建立舊版 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

    產生的範本排除 launch設定.json

  • --no-https

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

  • -uld|--use-local-db

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

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

    此專案的用戶端識別碼。 在獨立案例中搭配 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

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

    要用於 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 實例。 搭配 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

    產生的範本排除 launch設定.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 早于架構為目標的專案,請參閱 --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。 僅適用於 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 早于架構為目標的專案,請參閱 --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 覆寫。 由於 的預設值 --controllersfalse ,因此輸入 dotnet new webapi 而不指定任一選項會建立最小的 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

  • --controllers, --use-controllers

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

  • --domain <DOMAIN>

    目錄租使用者的網域。 搭配 IndividualB2CSingleOrg 驗證使用。 預設值是 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) 支援。 AddSwaggerGenUseSwagger 、 和 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


globaljson

  • --sdk-version <VERSION_NUMBER>

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

editorconfig

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

  • --empty

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

另請參閱