Training
Modul
Erstellen eines .NET Aspire-Projekts - Training
Erfahren Sie, wie Sie cloudnative Anwendungen von Grund auf neu erstellen oder einer vorhandenen App mithilfe des .NET Aspire-Stack in .NET 8 Orchestrierung hinzufügen.
Dieser Browser wird nicht mehr unterstützt.
Führen Sie ein Upgrade auf Microsoft Edge durch, um die neuesten Features, Sicherheitsupdates und den technischen Support zu nutzen.
.NET bietet ein Vorlagensystem, das Benutzern die Installation oder Deinstallation von Paketen mit enthaltenen Vorlagen über NuGet, eine NuGet-Paketdatei oder ein Dateisystemverzeichnis ermöglicht. In diesem Artikel wird beschrieben, wie Sie .NET-Vorlagen mit der CLI des .NET SDK verwalten.
Weitere Informationen zum Erstellen von Vorlagen finden Sie unter Tutorial: Erstellen von Vorlagen.
Vorlagenpakete werden mit dem SDK-Befehl dotnet new install installiert. Sie können entweder den NuGet-Paketbezeichner eines Vorlagenpakets oder einen Ordner mit den Vorlagendateien angeben.
.NET CLI-Vorlagenpakete werden zur weiteren Verteilung auf NuGet hochgeladen. Vorlagenpakete können auch über einen privaten Feed installiert werden. Anstatt ein Vorlagenpaket in einen NuGet-Feed hochzuladen, können NUPKG-Vorlagendateien verteilt und manuell installiert werden. Weitere Informationen hierzu finden Sie im Abschnitt Lokales NuGet-Paket.
Weitere Informationen zum Konfigurieren von NuGet-Feeds finden Sie unter dotnet nuget add source.
Verwenden Sie zum Installieren eines Vorlagenpakets über den NuGet-Standardfeed den Befehl dotnet new install {package-id}
:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
Verwenden Sie zum Installieren eines Vorlagenpakets mit einer bestimmten Version über den NuGet-Standardfeed den Befehl dotnet new install {package-id}::{version}
:
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.2.6
Beim Erstellen eines Vorlagenpaket wird eine NUPKG-Datei generiert. Wenn Sie eine NUPKG-Datei mit Vorlagen besitzen, können Sie diese mit dem Befehl dotnet new install {path-to-package}
installieren:
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 Alternative zum Installieren der Vorlage über eine NUPKG-Datei können Sie Vorlagen auch direkt mit dem dotnet new install {folder-path}
-Befehl aus einem Ordner installieren. Der angegebene Ordner wird als Vorlagenpaketbezeichner für jede gefundene Vorlage behandelt. Alle Vorlagen, die in der Hierarchie des angegebenen Ordners gefunden werden, werden installiert.
dotnet new install c:\code\nuget-packages\some-folder\
dotnet new install ~/code/nuget-packages/some-folder/
Der Parameter {folder-path}
im Befehl wird zum Vorlagenpaketbezeichner für alle gefundenen Vorlagen. Wie im Abschnitt Auflisten von Vorlagenpaketen erläutert, können Sie mit dem Befehl dotnet new uninstall
eine Liste der installierten Vorlagenpakete aufrufen. In diesem Beispiel wird der Vorlagenpaketbezeichner als der für die Installation verwendete Ordner angegeben:
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
Vorlagenpakete werden mit dem SDK-Befehl dotnet new uninstall deinstalliert. Sie können entweder den NuGet-Paketbezeichner eines Vorlagenpakets oder einen Ordner mit den Vorlagendateien angeben.
Nachdem ein NuGet-Vorlagenpaket entweder über einen NuGet-Feed oder eine NUPKG-Datei installiert wurde, können Sie es deinstallieren, indem Sie auf den NuGet-Paketbezeichner verweisen.
Verwenden Sie zum Deinstallieren eines Vorlagenpakets den Befehl dotnet new uninstall {package-id}
:
dotnet new uninstall Microsoft.DotNet.Web.Spa.ProjectTemplates
Wenn Vorlagen über einen Ordnerpfad installiert werden, wird der Ordnerpfad zum Vorlagenpaketbezeichner.
Verwenden Sie zum Deinstallieren eines Vorlagenpakets den Befehl dotnet new uninstall {package-folder-path}
:
dotnet new uninstall c:\code\nuget-packages\some-folder
dotnet new uninstall /home/username/code/templates
Wenn Sie den Standardbefehl zum Deinstallieren ohne Paketbezeichner verwenden, werden eine Liste der installierten Vorlagenpakete und der Befehl angezeigt, mit dem Sie die jeweiligen Vorlagenpakete deinstallieren können.
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
Wenn Sie die einzelnen Versionen des SDK sequenziell installiert haben, z. B. erst SDK 6.0, dann SDK 7.0 usw., sind auch die Vorlagen aller SDKs installiert. Wenn Sie jedoch mit einer späteren SDK-Version wie 7.0 beginnen, sind nur die Vorlagen dieser Version enthalten. Vorlagen für ein andere Releases sind nicht enthalten.
Die .NET-Vorlagen sind auf NuGet verfügbar und können wie jede andere Vorlage installiert werden. Weitere Informationen finden Sie unter Installieren von auf NuGet gehosteten Paketen.
Das .NET 9 SDK enthält z. B. Vorlagen für eine Konsolen-App für .NET 9. Wenn Sie die App für .NET Core 3.1 erstellen möchten, müssen Sie das Vorlagenpaket für Version 3.1 installieren.
Versuchen Sie, eine App für .NET Core 3.1 zu erstellen.
dotnet new console --framework netcoreapp3.1
Wenn folgende Fehlermeldung angezeigt wird, müssen Sie die Vorlagen installieren.
Installieren Sie die .NET Core 3.1-Projektvorlagen.
dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1
Erstellen Sie die App ein zweites Mal.
dotnet new console --framework netcoreapp3.1
Jetzt sollte eine Meldung angezeigt werden, die besagt, dass das Projekt erstellt wurde.
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.
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben:
Training
Modul
Erstellen eines .NET Aspire-Projekts - Training
Erfahren Sie, wie Sie cloudnative Anwendungen von Grund auf neu erstellen oder einer vorhandenen App mithilfe des .NET Aspire-Stack in .NET 8 Orchestrierung hinzufügen.