共用方式為

.NET .NET Aspire 範本

  • 發行項

有許多 .NET.NET Aspire 項目範本可供您使用。 您可以使用這些範本來建立完整的 .NET Aspire 解決方案，或將個別專案新增至現有的 .NET Aspire 解決方案。

.NET .NET Aspire 範本可在 📦Aspire中取得，ProjectTemplates NuGet 套件。

可用的範本

.NET Aspire 範本可讓您使用 .NET Aspire 解決方案結構和預設設定來建立預先設定的新應用程式。 這些專案也會在應用程式的不同資源之間提供統一的偵錯體驗。

.NET .NET Aspire 範本有兩個類別：方案範本和項目範本。 方案範本會建立具有多個專案的新 .NET Aspire 方案，而專案範本則會建立可新增至現有 .NET Aspire 解決方案的個別專案。

解決方案範本

下列 .NET.NET Aspire 解決方案範本可供使用，假設解決方案名為 AspireSample：

  • .NET .NET Aspire 空白應用程式：包含以下內容的基本 .NET.NET Aspire 專案：

項目範本

下列 .NET.NET Aspire 項目範本可供使用：

  • .NET .NET Aspire App Host：一個獨立的 AppHost 專案，可以用來協調與管理應用程式的不同專案和服務。

  • .NET .NET Aspire 測試專案：這些專案範本可用來為 .NET.NET Aspire 應用程式建立測試專案，而且其用途是代表功能和整合測試。 測試專案包含下列範本：

    • MSTest：一個包含 .NET.NET Aspire AppHost 專案的 MSTest 整合專案。
    • NUnit：包含 .NET.NET Aspire AppHost 專案的 NUnit 整合的專案。
    • xUnit：一個包含 xUnit.net 與 .NET.NET Aspire AppHost 專案整合的專案。

    如需測試範本的詳細資訊，請參閱 在 .NET.NET Aspire 中進行的測試。

  • .NET .NET Aspire 服務預設值：一個獨立的 .ServiceDefaults 專案，可以用來管理您的解決方案中與 恢復能力、服務發現和 遙測相關的多個專案中重複使用的組態。

    重要

    服務預設專案範本預設會將 FrameworkReference 作為對 Microsoft.AspNetCore.App的相依性。 這可能不適合某些項目類型。 如需詳細資訊，請參閱 .NET.NET Aspire 服務預設值。

使用範本建立方案和專案

若要建立 .NET Aspire 方案或專案，請使用 Visual Studio、Visual Studio Code或 .NET CLI，並以可用的範本為基礎。 在 .NET 存放庫中探索其他 .NET Aspire 範本。

若要使用 .NET Aspire建立 Visual Studio 專案，請在 Aspire 新專案視窗中搜尋 Visual Studio，然後選取所需的範本。

Visual Studio：.NET Aspire 範本。

請依照提示從範本設定專案或方案，然後選取 建立。

若要使用 .NET Aspire建立 Visual Studio Code 專案，請在 Aspire 新專案視窗中搜尋 Visual Studio Code，然後選取所需的範本。

Visual Studio Code：.NET Aspire 範本。

選取所需的位置、輸入名稱，然後選取 建立。

若要使用 .NET Aspire CLI 建立 .NET 方案或專案，請使用 dotnet new 命令，並指定您想要建立的範本。 請考慮下列範例：

若要建立以最新 .NET 版本為目標的基本 .NET 專案：

dotnet new aspire-apphost

若要建立 .NET.NET Aspire 入門應用程式，這是包含範例 UI 和支援 API 的完整解決方案：

dotnet new aspire-starter

提示

.NET Aspire 範本預設為使用最新的 .NET 版本，即使使用舊版的 .NET CLI 也一樣。 若要手動指定 .NET 版本，請使用 --framework <tfm> 選項，例如建立以 .NET 8 為目標的基本 .NET 專案：

dotnet new aspire-apphost --framework net8.0

另請參閱