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.

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 im .NET.NET Aspire Beispiele Repository.

Um ein .NET Aspire Projekt mit Visual Studiozu erstellen, suchen Sie im neuen Aspire Projektfenster nach Visual Studio 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 neuen Aspire Projektfenster nach Visual Studio Code 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 ein einfaches .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

Trinkgeld

.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