Verwalten von .NET-Projekt- und -Elementvorlagen
.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.
Installieren 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.
Gehostetes NuGet-Paket
.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
Lokales NuGet-Paket
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
Ordner
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
Deinstallieren des Vorlagenpakets
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.
NuGet-Paket
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
Ordner
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
Auflisten von Vorlagenpaketen
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
Installieren von Vorlagenpaketen aus anderen SDKs
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.1Wenn 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.1Erstellen Sie die App ein zweites Mal.
dotnet new console --framework netcoreapp3.1Jetzt 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.
