sjablonen voor .NET.NET Aspire
Er zijn een aantal .NET.NET Aspire projectsjablonen beschikbaar voor u. U kunt deze sjablonen gebruiken om volledige .NET Aspire oplossingen te maken of afzonderlijke projecten toe te voegen aan bestaande .NET Aspire-oplossingen.
De .NET.NET Aspire sjablonen zijn beschikbaar in de 📦Aspire. ProjectTemplates NuGet-pakket.
De .NET.NET Aspire-sjablonen installeren
Als u de .NET Aspire-sjablonen in Visual Studiowilt installeren, moet u deze handmatig installeren, tenzij u Visual Studio 17.12 of hoger gebruikt. Voor Visual Studio 17,9 tot en met 17.11 voert u de volgende stappen uit:
- Open Visual Studio.
- Ga naar Tools>NuGet Package Manager>Package Manager Console.
- Voer de volgende opdracht uit om de sjablonen te installeren:
dotnet new install Aspire.ProjectTemplates
Voor Visual Studio 17.12 of hoger worden de .NET Aspire-sjablonen automatisch geïnstalleerd.
Als u deze sjablonen wilt installeren, gebruikt u de opdracht dotnet new install en geeft u de Aspire.ProjectTemplates NuGet-id door.
dotnet new install Aspire.ProjectTemplates
Als u een specifieke versie wilt installeren, voegt u het versienummer toe aan de pakketnaam:
dotnet new install Aspire.ProjectTemplates::9.0.0
Tip
Als u de .NET.NET Aspire workload al hebt geïnstalleerd, moet u de --force vlag doorgeven om de bestaande sjablonen te overschrijven. U kunt gerust de .NET.NET Aspire workload verwijderen.
De .NET.NET Aspire-sjablonen weergeven
De .NET Aspire-sjablonen worden automatisch geïnstalleerd wanneer u Visual Studio 17.9 of hoger installeert. Als u wilt zien welke .NET.NET Aspire sjablonen beschikbaar zijn, selecteert u Bestand>Nieuw>Project- in Visual Studioen zoekt u in de zoekbalk naar 'Aspire' (Alt+S-). U ziet een lijst met beschikbare .NET.NET Aspire projectsjablonen:
Als u de beschikbare sjablonen in Visual Studio Code wilt weergeven waarop de C# DevKit is geïnstalleerd, selecteert u de knop Maken .NET Project wanneer er geen map wordt geopend in de Explorer- weergave:
Zoek vervolgens in de zoekbalk naar 'Aspire' om de beschikbare .NET Aspire projectsjablonen te bekijken:
Als u wilt controleren of de .NET.NET Aspire-sjablonen zijn geïnstalleerd, gebruikt u de opdracht dotnet new list en geeft u de naam van de aspire-sjabloon door:
dotnet new list aspire
De console-uitvoer moet er als volgt uitzien:
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
Beschikbare sjablonen
Met de .NET Aspire-sjablonen kunt u nieuwe apps maken die vooraf zijn geconfigureerd met de structuur van .NET Aspire oplossingen en standaardinstellingen. Deze projecten bieden ook een uniforme foutopsporingservaring voor de verschillende resources van uw app.
.NET .NET Aspire sjablonen zijn beschikbaar in twee categorieën: oplossingssjablonen en projectsjablonen. Oplossingssjablonen maken een nieuwe .NET Aspire oplossing met meerdere projecten, terwijl projectsjablonen afzonderlijke projecten maken die kunnen worden toegevoegd aan een bestaande .NET Aspire oplossing.
Oplossingssjablonen
De volgende .NET.NET Aspire oplossingssjablonen zijn beschikbaar, stel dat de oplossing de naam heeft AspireSample-:
.NET .NET Aspire Lege app-: een minimaal .NET.NET Aspire project dat het volgende bevat:
- AspireSample.AppHost: een orchestratorproject dat is ontworpen om de verschillende projecten en services van uw app te verbinden en te configureren.
- AspireSample.ServiceDefaults: een .NET.NET Aspire gedeeld project voor het beheren van configuraties die opnieuw worden gebruikt in de projecten in uw oplossing met betrekking tot tolerantie, servicedetectieen telemetrie.
.NET .NET Aspire Starter-app: naast de .AppHost en .ServiceDefaults projecten bevat de .NET.NET Aspire Starter-app ook het volgende:
- AspireSample.ApiService: er wordt een ASP.NET Core minimale API--project gebruikt om gegevens aan de front-end te leveren. Dit project is afhankelijk van het gedeelde AspireSample.ServiceDefaults project.
- AspireSample.Web: een ASP.NET CoreBlazor App-project met standaardconfiguraties voor .NET.NET Aspire service, is dit project afhankelijk van de AspireSample.ServiceDefaults project.
- AspireSample.Test: een MSTest, NUnitof xUnit testproject met projectverwijzingen naar de AspireSample.AppHost- en een voorbeeld van WebTests.cs bestand waarin een integratietest wordt gedemonstreerd.
Projectsjablonen
De volgende .NET.NET Aspire projectsjablonen zijn beschikbaar:
- .NET .NET Aspire App Host: een zelfstandige . AppHost-project dat kan worden gebruikt voor het organiseren en beheren van de verschillende projecten en services van uw app.
.NET .NET Aspire Testprojecten: deze projectsjablonen worden gebruikt om testprojecten voor uw .NET.NET Aspire-app te maken en ze zijn bedoeld om functionele en integratietests weer te geven. De testprojecten bevatten de volgende sjablonen:
- MSTest: een project dat MSTest-integratie van een .NET.NET Aspire AppHost-project bevat.
- NUnit: een project dat NUnit-integratie van een .NET.NET Aspire AppHost-project bevat.
- xUnit: een project dat xUnit.net integratie van een .NET.NET Aspire AppHost-project bevat.
Zie Testen in .NET.NET Aspirevoor meer informatie over de testsjablonen.
.NET .NET Aspire Service-standaardinstellingen: een zelfstandige . ServiceDefaults project dat kan worden gebruikt voor het beheren van configuraties die opnieuw worden gebruikt in de projecten in uw oplossing met betrekking tot tolerantie, servicedetectieen telemetrie.
Belangrijk
De standaardprojectsjabloon van de service heeft een
FrameworkReferenceafhankelijkheid vanMicrosoft.AspNetCore.App. Dit is mogelijk niet ideaal voor sommige projecttypen. Zie .NET.NET Aspire servicestandaardenvoor meer informatie.
Oplossingen en projecten maken met behulp van sjablonen
Als u een .NET Aspire oplossing of project wilt maken, gebruikt u Visual Studio, Visual Studio Codeof de .NET CLI en baset u deze op de beschikbare sjablonen. Bekijk aanvullende .NET.NET Aspire sjablonen in de .NET.NET Aspire samplevoorbeelden repository.
Als u een .NET Aspire project wilt maken met behulp van Visual Studio, zoekt u Aspire in het Visual Studio nieuwe projectvenster en selecteert u de gewenste sjabloon.
Volg de aanwijzingen om uw project of oplossing te configureren vanuit de sjabloon en selecteer vervolgens Maken.
Als u een .NET Aspire project wilt maken met behulp van Visual Studio Code, zoekt u Aspire in het Visual Studio Code nieuwe projectvenster en selecteert u de gewenste sjabloon.
Selecteer de gewenste locatie, voer een naam in en selecteer maken.
Als u een .NET Aspire oplossing of project wilt maken met behulp van de .NET CLI, gebruikt u de opdracht dotnet new en geeft u op welke sjabloon u wilt maken. Bekijk de volgende voorbeelden:
Een eenvoudige .NET.NET Aspire app-host maken project gericht op de meest recente .NET versie:
dotnet new aspire-apphost
Voor het maken van een .NET.NET Aspire starter-app, een volledige oplossing met een voorbeeldgebruikersinterface en back-up-API:
dotnet new aspire-starter
Fooi
.NET Aspire sjablonen gebruiken standaard de nieuwste .NET versie, zelfs wanneer u een eerdere versie van de .NET CLI gebruikt. Als u de .NET-versie handmatig wilt opgeven, gebruikt u de optie --framework <tfm>, bijvoorbeeld om een eenvoudige .NET.NET Aspire app-hostproject te maken dat zich richt op .NET 8:
dotnet new aspire-apphost --framework net8.0
