Freigeben über

.NET .NET Aspire-Vorlagen

  • Artikel

Es gibt eine Reihe von .NET.NET Aspire Projektvorlagen, die Ihnen zur Verfügung stehen. Sie können diese Vorlagen verwenden, um vollständige .NET Aspire Lösungen zu erstellen oder einzelne Projekte zu vorhandenen .NET Aspire Lösungen hinzuzufügen.

Die .NET.NET Aspire-Vorlagen sind im 📦AspireProjectTemplates NuGet-Paket verfügbar.

Installieren Sie die .NET- und.NET Aspire-Vorlagen

Um die .NET Aspire-Vorlagen in Visual Studiozu installieren, müssen Sie sie manuell installieren, es sei denn, Sie verwenden Visual Studio 17.12 oder höher. Führen Sie für Visual Studio 17.9 bis 17.11 die folgenden Schritte aus:

  1. Öffnen Sie Visual Studio.
  2. Wechseln Sie zu Tools>NuGet Package Manager>Package Manager Console.
  3. Führen Sie den folgenden Befehl aus, um die Vorlagen zu installieren:
dotnet new install Aspire.ProjectTemplates

Für Visual Studio 17.12 oder später werden die .NET Aspire-Vorlagen automatisch installiert.

Verwenden Sie zum Installieren dieser Vorlagen den Befehl dotnet new install, und übergeben Sie den Aspire.ProjectTemplates NuGet-Bezeichner.

dotnet new install Aspire.ProjectTemplates

Um eine bestimmte Version zu installieren, fügen Sie die Versionsnummer an den Paketnamen an:

dotnet new install Aspire.ProjectTemplates::9.0.0

Trinkgeld

Wenn Sie die .NET.NET Aspire Workload bereits installiert haben, müssen Sie das --force Flag übergeben, um die vorhandenen Vorlagen zu überschreiben. Sie können die .NET.NET Aspire Workload deinstallieren.

Liste der .NET-.NET Aspire-Vorlagen

Die .NET Aspire Vorlagen werden automatisch installiert, wenn Sie Visual Studio 17.9 oder höher installieren. Um zu sehen, welche .NET.NET Aspire Vorlagen verfügbar sind, wählen Sie Datei>Neues>Projekt in Visual Studio, und suchen Sie in der Suchleiste nach "Aspire" (Alt+S). Es wird eine Liste der verfügbaren .NET.NET Aspire Projektvorlagen angezeigt:

Visual Studio: Erstellen Sie ein neues Projekt, und suchen Sie nach

Wenn Sie die verfügbaren Vorlagen in Visual Studio Code mit dem installierten C#DevKit anzeigen möchten, wählen Sie die Schaltfläche Projekt erstellen .NET aus, wenn in der ansicht Explorer kein Ordner geöffnet wird:

Visual Studio Code: Schaltfläche

Suchen Sie dann in der Suchleiste nach "Aspire", um die verfügbaren .NET Aspire Projektvorlagen anzuzeigen:

Visual Studio Code: Erstellen Sie ein neues Projekt, und suchen Sie nach

Um zu überprüfen, ob die .NET.NET Aspire Vorlagen installiert sind, verwenden Sie den Befehl dotnet new list und geben Sie den Namen der aspire Vorlage an.

dotnet new list aspire

Die Konsolenausgabe sollte wie folgt aussehen:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire App Host               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

Verfügbare Vorlagen

Mit den .NET Aspire Vorlagen können Sie neue Apps erstellen, die mit der .NET Aspire Lösungsstruktur und den Standardeinstellungen vorkonfiguriert sind. Diese Projekte bieten auch eine einheitliche Debugerfahrung in den verschiedenen Ressourcen Ihrer App.

.NET .NET Aspire Vorlagen sind in zwei Kategorien verfügbar: Lösungsvorlagen und Projektvorlagen. Lösungs-Vorlagen erstellen eine neue .NET Aspire-Lösung mit mehreren inbegriffenen Projekten, während Projektvorlagen einzelne Projekte erstellen, die zu einer bestehenden .NET Aspire-Lösung hinzugefügt werden können.

Lösungsvorlagen

Die folgenden .NET.NET Aspire Lösungsvorlagen sind verfügbar, vorausgesetzt, die Lösung heißt AspireSample:

  • .NET .NET Aspire Leere App: Ein minimales .NET.NET Aspire Projekt, das Folgendes umfasst:

Projektvorlagen

Die folgenden .NET.NET Aspire Projektvorlagen sind verfügbar:

  • .NET .NET Aspire App-Host-: Ein eigenständiges . AppHost Projekt, das verwendet werden kann, um die verschiedenen Projekte und Dienste Ihrer App zu koordinieren und zu verwalten.

  • .NET .NET Aspire Testprojekte: Diese Projektvorlagen werden verwendet, um Testprojekte für Ihre .NET.NET Aspire-App zu erstellen, und sie sollen Funktions- und Integrationstests darstellen. Die Testprojekte enthalten die folgenden Vorlagen:

    • MSTest: Ein Projekt, das die MSTest-Integration eines .NET.NET Aspire AppHost-Projekts enthält.
    • NUnit: Ein Projekt, das die NUnit-Integration eines .NET.NET Aspire AppHost-Projekts enthält.
    • xUnit-: Ein Projekt, das die Integration von xUnit.net für ein .NET.NET Aspire AppHost-Projekt beinhaltet.

    Weitere Informationen zu den Testvorlagen finden Sie im Abschnitt Testing in .NET.NET Aspire.

  • .NET .NET Aspire Service Defaults: Ein eigenständiges .ServiceDefaults Projekt, das zur Verwaltung von Konfigurationen genutzt werden kann, die in Ihrer Lösung projektübergreifend im Zusammenhang mit Resilienz, Dienstermittlungund Telemetriewiederverwendet werden.

    Wichtig

    Die Standardvorlage für Dienstprojekte erfordert eine FrameworkReference-Abhängigkeit von Microsoft.AspNetCore.App. Dies ist für einige Projekttypen möglicherweise nicht ideal. Weitere Informationen finden Sie unter .NET.NET Aspire Dienststandardeinstellungen.

Erstellen von Lösungen und Projekten mithilfe von Vorlagen

Um eine .NET Aspire Lösung oder ein Projekt zu erstellen, verwenden Sie Visual Studio, Visual Studio Codeoder die .NET CLI, und basieren Sie auf den verfügbaren Vorlagen. Weitere .NET.NET Aspire Vorlagen finden Sie in den .NET.NET Aspire Beispielen Repository.

Um ein .NET Aspire Projekt mit Visual Studiozu erstellen, suchen Sie im neuen Visual Studio Projektfenster nach Aspire und wählen Sie die gewünschte Vorlage aus.

Visual Studio: .NET Aspire Vorlagen.

Folgen Sie den Anweisungen, um Ihr Projekt oder Ihre Projektmappe aus der Vorlage zu konfigurieren, und wählen Sie anschließend Erstellen.

Um ein .NET Aspire Projekt mit Visual Studio Codezu erstellen, suchen Sie im Visual Studio Code neuen Projektfenster nach Aspire, und wählen Sie die gewünschte Vorlage aus.

Visual Studio Code: .NET Aspire Vorlagen.

Wählen Sie den gewünschten Speicherort aus, geben Sie einen Namen ein, und wählen Sie Erstellenaus.

Verwenden Sie zum Erstellen einer .NET Aspire Lösung oder eines Projekts mithilfe der .NET CLI den Befehl dotnet new, um anzugeben, welche Vorlage Sie erstellen möchten. Betrachten Sie die folgenden Beispiele:

So erstellen Sie einen einfachen .NET.NET Aspire App-Host Projekt für die neueste .NET Version:

dotnet new aspire-apphost

So erstellen Sie eine .NET.NET Aspire Start-App, die eine vollständige Lösung mit einer Beispiel-UI und einer unterstützenden API bietet:

dotnet new aspire-starter

Tipp

.NET Aspire-Vorlagen verwenden standardmäßig die neueste .NET-Version, selbst wenn eine frühere Version der .NET-CLI genutzt wird. Verwenden Sie zum manuellen Angeben der .NET-Version die Option --framework <tfm>, z. B. zum Erstellen eines einfachen .NET.NET Aspire-App-Host-Projekts für .NET 8:

dotnet new aspire-apphost --framework net8.0

Siehe auch