Training
Module
Een .NET Aspire-project maken - Training
Meer informatie over het maken van volledig nieuwe cloudtoepassingen of het toevoegen van indeling aan een bestaande app met behulp van de .NET Aspire-stack in .NET 8.
Deze browser wordt niet meer ondersteund.
Upgrade naar Microsoft Edge om te profiteren van de nieuwste functies, beveiligingsupdates en technische ondersteuning.
.NET biedt een sjabloonsysteem waarmee gebruikers pakketten met sjablonen kunnen installeren of verwijderen uit NuGet, een NuGet-pakketbestand of een bestandssysteemmap. In dit artikel wordt beschreven hoe u .NET-sjablonen beheert via de .NET SDK CLI.
Zie Zelfstudie: Sjablonen maken voor meer informatie over het maken van sjablonen.
Sjabloonpakketten worden geïnstalleerd via de dotnet new installatie-SDK-opdracht . U kunt de NuGet-pakket-id van een sjabloonpakket opgeven of een map die de sjabloonbestanden bevat.
.NET CLI-sjabloonpakketten worden geüpload naar NuGet voor brede distributie. Sjabloonpakketten kunnen ook worden geïnstalleerd vanuit een privéfeed. In plaats van een sjabloonpakket te uploaden naar een NuGet-feed, kunnen nupkg-sjabloonbestanden worden gedistribueerd en handmatig geïnstalleerd, zoals beschreven in de sectie Lokaal NuGet-pakket .
Zie voor meer informatie over het configureren van NuGet-feeds dotnet nuget add source.
Als u een sjabloonpakket wilt installeren vanuit de standaard NuGet-feed, gebruikt u de dotnet new install {package-id}
opdracht:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
Als u een sjabloonpakket wilt installeren vanuit de standaard NuGet-feed met een specifieke versie, gebruikt u de dotnet new install {package-id}::{version}
opdracht:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.2.6
Wanneer een sjabloonpakket wordt gemaakt, wordt er een nupkg-bestand gegenereerd. Als u een nupkg-bestand met sjablonen hebt, kunt u het installeren met de dotnet new install {path-to-package}
opdracht:
dotnet new install c:\code\nuget-packages\Some.Templates.1.0.0.nupkg
dotnet new install ~/code/nuget-packages/Some.Templates.1.0.0.nupkg
Als alternatief voor het installeren van een sjabloon vanuit een nupkg-bestand , kunt u sjablonen ook rechtstreeks vanuit een map installeren met de dotnet new install {folder-path}
opdracht. De opgegeven map wordt behandeld als de sjabloonpakket-id voor alle gevonden sjablonen. Een sjabloon die in de opgegeven maphiërarchie is gevonden, is geïnstalleerd.
dotnet new install c:\code\nuget-packages\some-folder\
dotnet new install ~/code/nuget-packages/some-folder/
De {folder-path}
opgegeven opdracht wordt de sjabloonpakket-id voor alle gevonden sjablonen. Zoals opgegeven in de sectie Lijstsjabloonpakketten , kunt u een lijst met sjabloonpakketten ophalen die zijn geïnstalleerd met de dotnet new uninstall
opdracht. In dit voorbeeld wordt de sjabloonpakket-id weergegeven als de map die wordt gebruikt voor de installatie:
dotnet new uninstall
Currently installed items:
... cut to save space ...
c:\code\nuget-packages\some-folder
Templates:
A Template Console Class (templateconsole) C#
Project for some technology (contosoproject) C#
Uninstall Command:
dotnet new uninstall c:\code\nuget-packages\some-folder
dotnet new uninstall
Currently installed items:
... cut to save space ...
/home/username/code/templates
Templates:
A Template Console Class (templateconsole) C#
Project for some technology (contosoproject) C#
Uninstall Command:
dotnet new uninstall /home/username/code/templates
Sjabloonpakketten worden verwijderd via de dotnet new opdracht SDK verwijderen . U kunt de NuGet-pakket-id van een sjabloonpakket opgeven of een map die de sjabloonbestanden bevat.
Nadat een NuGet-sjabloonpakket is geïnstalleerd, kunt u dit verwijderen vanuit een NuGet-feed of een nupkg-bestand door te verwijzen naar de NuGet-pakket-id.
Als u een sjabloonpakket wilt verwijderen, gebruikt u de dotnet new uninstall {package-id}
opdracht:
dotnet new uninstall Microsoft.DotNet.Web.Spa.ProjectTemplates
Wanneer sjablonen worden geïnstalleerd via een mappad, wordt het mappad de sjabloonpakket-id.
Als u een sjabloonpakket wilt verwijderen, gebruikt u de dotnet new uninstall {package-folder-path}
opdracht:
dotnet new uninstall c:\code\nuget-packages\some-folder
dotnet new uninstall /home/username/code/templates
Met de standaardopdracht verwijderen zonder pakket-id ziet u een lijst met geïnstalleerde sjabloonpakketten, samen met de opdracht waarmee elk sjabloonpakket wordt verwijderd.
dotnet new uninstall
Currently installed items:
... cut to save space ...
c:\code\nuget-packages\some-folder
Templates:
A Template Console Class (templateconsole) C#
Project for some technology (contosoproject) C#
Uninstall Command:
dotnet new uninstall c:\code\nuget-packages\some-folder
Als u elke versie van de SDK sequentieel hebt geïnstalleerd, bijvoorbeeld als u SDK 6.0 hebt geïnstalleerd, hebt u SDK 7.0 enzovoort geïnstalleerd. Als u echter begint met een latere SDK-versie, zoals 7.0, worden alleen de sjablonen voor deze versie opgenomen. Sjablonen voor andere versies zijn niet opgenomen.
De .NET-sjablonen zijn beschikbaar op NuGet en u kunt ze installeren zoals elke andere sjabloon. Zie NuGet-gehost pakket installeren voor meer informatie.
De .NET 9 SDK bevat bijvoorbeeld sjablonen voor een console-app die is gericht op .NET 9. Als u .NET Core 3.1 wilt targeten, moet u het sjabloonpakket 3.1 installeren.
Probeer een app te maken die is gericht op .NET Core 3.1.
dotnet new console --framework netcoreapp3.1
Als u een foutbericht ziet, moet u de sjablonen installeren.
Installeer de .NET Core 3.1-projectsjablonen.
dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1
Probeer de app een tweede keer te maken.
dotnet new console --framework netcoreapp3.1
En u ziet nu een bericht dat aangeeft dat het project is gemaakt.
The template "Console Application" was created successfully.
Processing post-creation actions...
Running 'dotnet restore' on path-to-project-file.csproj...
Determining projects to restore...
Restore completed in 1.05 sec for path-to-project-file.csproj.
Restore succeeded.
.NET-feedback
.NET is een open source project. Selecteer een koppeling om feedback te geven:
Training
Module
Een .NET Aspire-project maken - Training
Meer informatie over het maken van volledig nieuwe cloudtoepassingen of het toevoegen van indeling aan een bestaande app met behulp van de .NET Aspire-stack in .NET 8.