Tutorial: Erste Schritte mit ASP.NET Core

Dieses Tutorial zeigt, wie Sie eine ASP.NET Core-Web-App über die .NET Core-CLI erstellen und ausführen.

Sie lernen, die folgende Aufgaben auszuführen:

• Erstellen Sie ein Web-App-Projekt.
• Vertrauen Sie dem Entwicklungszertifikat.
• Führen Sie die App aus.
• Bearbeiten Sie eine Razor-Seite.

Am Schluss werden Sie eine funktionierende Web-App auf Ihrem lokalen Computer besitzen.

Voraussetzungen

.NET 6.0 SDK

.NET 5.0 SDK

.NET Core 3.1 SDK

Erstellen Sie ein Web-App-Projekt.

Öffnen Sie eine Befehlsshell, und geben Sie den folgenden Befehl ein:

dotnet new webapp -o aspnetcoreapp

Für den obigen Befehl gilt Folgendes:

• Erstellt eine neue Web-App.
• Mit dem -o aspnetcoreapp-Parameter wird ein Verzeichnis mit dem Namen aspnetcoreapp und den Quelldateien für die App erstellt.

Dem Entwicklungszertifikat vertrauen

Vertrauen Sie dem HTTPS-Entwicklungszertifikat:

Windows

dotnet dev-certs https --trust

Über den vorherigen Befehl wird der folgende Dialog angezeigt:

Klicken Sie auf Ja, wenn Sie zustimmen möchten, dass das Entwicklungszertifikat vertrauenswürdig ist.

macOS

dotnet dev-certs https --trust

Über den vorherigen Befehl wird die folgende Meldung angezeigt:

Trusting the HTTPS development certificate was requested. Wenn das Zertifikat nicht bereits vertrauenswürdig ist, führen wir den folgenden Befehl aus: 'sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain <<certificate>>'

Dieser Befehl fordert Sie möglicherweise zur Eingabe Ihres Kennworts auf, um das Zertifikat in der Keychain für das System zu installieren. Geben Sie Ihr Kennwort ein, wenn Sie die Vertrauenswürdigkeit des Entwicklungszertifikats bestätigen möchten.

Linux

Weitere Informationen zum Bestätigen der Vertrauenswürdigkeit eines HTTPS-Entwicklungszertifikats finden Sie in der Dokumentation zu Ihrer Linux-Distribution.

Weitere Informationen finden Sie unter Festlegen des ASP.NET Core-HTTPS-Entwicklungszertifikat als vertrauenswürdig.

Ausführen der App

Führen Sie die folgenden Befehle aus:

cd aspnetcoreapp
dotnet watch run

Nachdem die Befehlsshell angibt, dass die App gestartet wurde, müssen Sie zu https://localhost:{port} wechseln, wobei {port} der verwendete zufällige Port ist.

Bearbeiten einer Razor-Seite

Öffnen Sie Pages/Index.cshtml, und ändern und speichern Sie die Seite mit dem folgenden hervorgehobenen Markup:

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Hello, world! The time on the server is @DateTime.Now</p>
</div>

Navigieren Sie zu https://localhost:{port}, aktualisieren Sie die Seite, und überprüfen Sie, ob die Änderungen angezeigt werden.

Nächste Schritte

In diesem Tutorial haben Sie gelernt, wie die folgenden Aufgaben ausgeführt werden:

• Erstellen Sie ein Web-App-Projekt.
• Vertrauen Sie dem Entwicklungszertifikat.
• Führen Sie das Projekt aus.
• Führen Sie eine Änderung durch.

Um mehr über ASP.NET Core zu erfahren, lesen Sie Folgendes:

Übersicht über ASP.NET Core