Skip to content

1. Einleitung

Das PDF des Dokuments finden Sie |HIER|.

Den Code des Dokuments finden Sie |HIER|.

Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Es knüpft an das Dokument „Schritt-für-Schritt-Einführung in das Web-Framework [NestJS]“ (2026) an, das seinerseits das Dokument „Einführung in ASP.NET MVC anhand von Beispielen“ (2013) an das Framework [NestJS] angepasst hat. Dieses Dokument geht den umgekehrten Weg und kehrt zur Plattform [.NET] in ihrer aktuellen Version zurück:

  • das Framework [NestJS] und die Sprache [TypeScript] werden durch das Framework [ASP.NET Core MVC] und die Sprache [C#] ersetzt;
  • die [Handlebars]-Views werden durch [Razor]-Views ersetzt;
  • ORM und [TypeORM] werden durch ORM und [Entity Framework Core] ersetzt, weiterhin auf Basis von [MySQL].

Das Dokument folgt eng dem Aufbau des Kurses zu [NestJS]: zunächst zahlreiche kleine Projekte, die jeweils ein einzelnes Konzept behandeln, danach eine umfassende Fallstudie – eine Webanwendung zur Terminplanung für eine Arztpraxis – mit vollständig kommentierten Dateien. Die Beispiele tragen dieselben Nummern und behandeln dieselben Themen wie im Kurs zu [NestJS]: Wer diesen Kurs kennt, kann die beiden Frameworks Beispiel für Beispiel vergleichen. Das ist jedoch nicht nötig: Dieses Dokument ist in sich abgeschlossen und setzt keine Vorkenntnisse in [NestJS] und auch nicht in [ASP.NET] voraus. Die einzigen Voraussetzungen sind Grundkenntnisse der Webprogrammierung (das HTTP-Protokoll, die Sprache HTML) und die Sprache [C#].

1.1. Die Rolle von ASP.NET Core MVC in einer Webanwendung

Eine Webanwendung ist oft in Schichten aufgebaut, wobei jede Schicht nur mit ihren Nachbarschichten kommuniziert:

Image

  • Die Web-Schicht empfängt HTTP-Anfragen vom Browser und liefert ihm HTML-Seiten zurück. Bei dieser Schicht hilft uns [ASP.NET Core MVC] beim Schreiben;
  • Die Geschäftsschicht enthält die Geschäftsregeln der Anwendung (zum Beispiel „ein Patient kann nur einen bevorstehenden Termin haben“). Sie weiß nichts vom Web: Sie könnte genauso gut eine Kommandozeilenanwendung bedienen;
  • Die Datenzugriffsschicht (DAO-Schicht, [DAO] für [Data Access Object]) liest aus der Datenbank und schreibt in sie. Wir verwenden den ORM [Entity Framework Core] ([Object Relational Mapper]), der die Zeilen der Tabellen auf Objekte in [C#] abbildet.

Die Web-Schicht selbst folgt dem Modell [MVC] ([Model – View – Controller]):

  • Der Controller (C) ist eine Klasse, deren Methoden – Actions genannt – jeweils einen bestimmten Anfragetyp bearbeiten (zum Beispiel [GET /schedule]). Eine Action liest die Anfrageparameter, ruft die Geschäftsschicht auf und wählt anschließend die anzuzeigende View aus;
  • Das Modell (M) ist die Menge der Daten, die die Action an die View übergibt: ein [C#]-Objekt;
  • Die View (V) ist eine [Razor]-Datei (Erweiterung [.cshtml]): ausgehend von HTML, in dem [C#]-Ausdrücke – eingeleitet durch das Zeichen [@] – durch Daten aus dem Modell ersetzt werden.

Die Verarbeitung einer Anfrage folgt den nummerierten Schritten im Diagramm:

  • 1: Der Browser sendet eine HTTP-Anfrage, zum Beispiel [GET /schedule?doctorId=1&day=2026-09-24];
  • 2: Der Webserver [Kestrel], in [ASP.NET Core] integriert, empfängt die Anfrage. Sie durchläuft eine Reihe von Middleware-Komponenten (Lesen von Cookies, Authentifizierung, statische Dateien usw.), anschließend wählt [ASP.NET Core] die Action aus, die für diese Anfrage zuständig ist: Das ist das Routing. Bevor die Anfrage die Action erreicht, kann sie noch Filter durchlaufen, die wir in späteren Kapiteln untersuchen;
  • 3: Die Action fordert die benötigten Daten von der Geschäftsschicht an;
  • 4: Sie erstellt das Modell der View und bestimmt die View, die es anzeigen soll;
  • 5: Die [Razor]-View-Engine erzeugt die HTML-Seite, die [ASP.NET Core] an den Browser zurückgibt.

[ASP.NET Core] ist das Web-Framework der Plattform [.NET] von Microsoft. Es ist kostenlos und quelloffen und läuft unter [Windows], [Linux] und [macOS]. Es kann Server erstellen, die JSON an einen [JavaScript]-Client ([Angular], [React], [Flutter] ...) liefern, ebenso wie klassische Webanwendungen, bei denen der Server die HTML-Seiten erzeugt und der Browser sie lediglich anzeigt. Dieser zweite Anwendungsfall – der MVC-Teil des Frameworks – wird in diesem Dokument behandelt. Wie [NestJS], das sich stark daran orientiert hat, beruht [ASP.NET Core] auf zwei Ideen: Attribute ([[HttpGet]], [[Route]], [[Authorize]] ...) beschreiben die Aufgaben von Klassen und Methoden, und Dependency Injection versorgt jedes Objekt mit den Abhängigkeiten, die es benötigt.

1.2. Verwendete Werkzeuge

Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation wird im Anhang beschrieben):

  • das [.NET]-10-SDK ([Software Development Kit]), das den [C#]-Compiler, das Framework [ASP.NET Core] und das Kommandozeilenwerkzeug [dotnet] enthält. [.NET] 10 ist die aktuelle LTS-Version (Long-Term Support);
  • der Editor [Visual Studio Code] mit der Erweiterung [C# Dev Kit];
  • ein aktueller Browser ([Chrome], [Firefox], [Edge]);
  • das Kommandozeilenwerkzeug [curl], das die rohen HTTP-Antworten anzeigt (es ist in [Windows] 10 und 11 enthalten);
  • das DBMS [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows], ab dem Kapitel zum Datenzugriff und für die Fallstudie.

Das Framework [ASP.NET Core] ist Teil des SDK: Die Beispiele benötigen bis Kapitel 8 keine zusätzlichen Bibliotheken. Die Beispiele 25 bis 28 und die Fallstudie verwenden drei Bibliotheken, die bei der ersten Kompilierung automatisch von der Website [nuget.org] heruntergeladen werden (Sie müssen an diesem Tag also mit dem Internet verbunden sein): [Microsoft.AspNetCore.Authentication.JwtBearer] (JWT-Token), [BCrypt.Net-Next] (Passwort-Hashes) und [Pomelo.EntityFrameworkCore.MySql] ([Entity Framework Core] für [MySQL]).

1.3. Die Fallstudie ausführen

Anmerkung des Rezensenten: Ich rate dem Leser, die Fallstudie sofort wie unten beschrieben durchzuführen. Sobald Sie die Rolle dieser Terminplanungsanwendung vollständig verstanden haben, bitten Sie Ihre bevorzugte KI, die Anwendung wie folgt zu ändern: Ab sofort kann jeder Arzt:

  • seine eigenen Terminslots zwischen zwei Daten festlegen. So kann er seinen Terminkalender nach Bedarf anpassen;
  • bestimmte Zeitslots für einen bestimmten Tag aus dem Kalender entfernen – zum Beispiel, wenn er aus persönlichen Gründen nicht verfügbar ist;

Die Änderung ist nicht trivial, da sie eine Änderung der Datenbankstruktur erfordert. Bitten Sie die KI, Ihnen den neuen Anwendungscode und das SQL-Skript zur Erstellung der neuen Datenbank zu liefern. Dazu müssen Sie ihr die ZIP-Datei mit dem vollständigen Projekt sowie das SQL-Skript der alten Datenbank zur Verfügung stellen.

Außerdem habe ich den von Claude erstellten Kurs nicht durchgesehen. Er hatte bereits einen perfekten [NestJS]-Kurs erstellt. Ich bin davon ausgegangen, dass das auch hier der Fall ist. Wenn Sie etwas nicht verstehen, ist die Lösung immer dieselbe: Bitten Sie Ihre bevorzugte KI, Ihnen zu erklären, was Sie nicht verstehen. Claude zum Beispiel ist darin sehr gut. Möglicherweise müssen Sie ihm das Beispiel, das Sie nicht verstehen, „hochladen“.

Ende der Anmerkung.

Die Fallstudie am Ende dieses Dokuments ist eine vollständige Anwendung. Leser werden sie vermutlich in Aktion sehen wollen, bevor sie sich in die Details des Frameworks vertiefen: Hier steht, wie Sie sie ausführen. Sie befindet sich im Ordner [rdvmedecins2-aspnetcore-mvc], neben dem Ordner [examples]:

1
2
3
aspnetcore-mvc-sept-2026/
├── examples/
└── rdvmedecins2-aspnetcore-mvc/

Sie müssen das SDK [.NET] 10, [Visual Studio Code] und [MySQL] installiert haben (siehe Anhänge). Dann:

  • Erstellen Sie die Datenbank [dbrdvmedecins2] , indem Sie das Skript [rdvmedecins2-aspnetcore-mvc/database/dbrdvmedecins2.sql] ausführen. Öffnen Sie mit [Laragon] das Werkzeug [HeidiSQL] (Schaltfläche „Datenbank“) und führen Sie das Skript dann über das Menü „Datei / SQL ausführen“ aus. In der Kommandozeile:
mysql -u root < database/dbrdvmedecins2.sql
  • Prüfen Sie die Datenbankverbindung. Die Anwendung verbindet sich mit [MySQL] auf [localhost], Port 3306, mit dem Benutzer [root] ohne Passwort (den Standardeinstellungen von [Laragon]). Wenn Ihr Konto [root] ein Passwort hat, tragen Sie es in der Datei [appsettings.json] der Anwendung am Ende der Verbindungszeichenfolge [ConnectionStrings:RdvMedecins] ein ([...;User=root;Password=myPassword;]). Geben Sie bei [MariaDB] außerdem deren Version im Schlüssel [MySql:ServerVersion] an (zum Beispiel [10.11.0-mariadb]);
  • Öffnen Sie den Ordner [rdvmedecins2-aspnetcore-mvc] in [Visual Studio Code] (Menü „Datei / Ordner öffnen“) und öffnen Sie dann ein Terminal (Menü „Terminal / Neues Terminal“);
  • Starten Sie die Anwendung:
dotnet run
  • Bei der ersten Ausführung lädt [dotnet] die Bibliotheken von [nuget.org] herunter, kompiliert die Anwendung und startet sie anschließend. Die Konsole zeigt dann die Adresse der Anwendung an:
Using launch settings from Properties/launchSettings.json...
Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:8081
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\course\rdvmedecins2-aspnetcore-mvc
  • Öffnen Sie die Adresse [http://localhost:8081] in einem Browser:

Image

  • Melden Sie sich mit einem der Demokonten an, deren Passwort mit dem Benutzernamen identisch ist: [admin] (Administrator), [pelissier], [tatou], [dupont] (Ärzte), [martin], [durand], [bistrou], [german] (Patienten). Außerdem müssen Sie die Zeichen aus dem Bild eingeben, in Groß- oder Kleinschreibung.

Wenn sich die Anwendung sofort mit der Meldung [Unable to connect to any of the specified MySQL hosts] beendet, bedeutet das, dass [MySQL] nicht gestartet wurde; bei [Access denied for user 'root'@'localhost'] ist das Passwort in der Verbindungszeichenfolge falsch; bei [Unknown database 'dbrdvmedecins2'] wurde das SQL-Skript nicht ausgeführt. Die Datei [README.md] der Anwendung beschreibt weitere Szenarien. Die Anwendung wird mit [Ctrl-C] im Terminal beendet.

Das letzte Kapitel des Dokuments erklärt, wie die Anwendung benutzt wird, und behandelt dann jede ihrer Dateien.

1.4. Beispiele

Die Beispiele liegen im Ordner [examples], mit einem Unterordner pro Beispiel:

1
2
3
4
5
6
7
8
9
examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   └── bootstrap/
├── Directory.Build.props
└── examples.slnx

Jedes Beispiel ist ein eigenständiges [.NET]-Projekt, das für sich kompiliert und ausgeführt werden kann. Die Datei [examples.slnx] ist eine Projektmappe: eine Liste aller dieser Projekte. Wenn Sie den Ordner [examples] in [Visual Studio Code] öffnen, findet die Erweiterung [C# Dev Kit] die Projektmappe und lädt alle Projekte (Bereich „Projektmappen-Explorer“): Sie haben dann in jeder Datei Syntaxhervorhebung, Codevervollständigung und Fehlermeldungen zur Verfügung.

Der Ordner [common/bootstrap] enthält das CSS und die [Bootstrap]-Frameworks, die von den Beispielen gemeinsam genutzt werden, die ihre Seiten formatieren (ab Beispiel 15).

Jedes Beispiel hat die Struktur eines [ASP.NET Core MVC]-Projekts:

13-first-view/
├── Controllers/
│   └── ViewsController.cs
├── Models/
│   └── PageModel.cs
├── Views/
│   ├── Views/
│   │   ├── Index.cshtml
│   │   └── Unknown.cshtml
│   └── _ViewImports.cshtml
├── appsettings.json
├── Example13.csproj
└── Program.cs
  • [Program.cs]: der Einstiegspunkt der Anwendung – Konfiguration, Services und Serverstart;
  • [Controllers]: die Controller;
  • [Models]: die Klassen, die die Modelle beschreiben (Actions und Views);
  • [Views]: die [Razor]-Views (ab Kapitel 4);
  • [appsettings.json]: die Konfiguration der Anwendung (Protokollierungsstufen und später die Datenbankverbindung usw.);
  • [Example13.csproj]: die Projektdatei, die beschreibt, wie die Anwendung kompiliert wird.

Um ein Beispiel auszuführen, öffnen Sie ein Terminal in seinem Ordner (in [Visual Studio Code]: Rechtsklick auf den Beispielordner, dann „In integriertem Terminal öffnen“ auswählen) und geben Sie ein:

dotnet run

[dotnet run] kompiliert das Projekt (in dessen Ordner [bin]) und führt die Anwendung dann aus. Mit [dotnet watch] wird der Code neu kompiliert und die Anwendung neu gestartet, sobald eine Datei vom Typ [.cs] oder [.cshtml] geändert wird:

dotnet watch

Alle Beispiele lauschen auf Port 5000, dem Standardport von [ASP.NET Core]: Es kann also immer nur eines laufen. Beenden Sie den Server mit [Ctrl-C] im Terminal. Sie können auch alle Beispiele auf einmal aus dem Ordner [examples] heraus kompilieren, um zu prüfen, ob die Installation vollständig ist:

dotnet build examples.slnx

Die Projektdatei eines Beispiels besteht nur aus einer einzigen Zeile. Zum Beispiel [01-structure/Example01.csproj]:

<Project Sdk="Microsoft.NET.Sdk.Web">
</Project>
  • Zeile 1: [Microsoft.NET.Sdk.Web] ist das SDK für Webanwendungen. Es stellt allein das gesamte Framework [ASP.NET Core] bereit: Controller, Views, Konfiguration, Webserver ...

Die Einstellungen, die allen Beispielen gemeinsam sind, werden nur einmal in der Datei [examples/Directory.Build.props] geschrieben, die der Compiler automatisch für jedes Projekt im Ordner [examples] liest:

<!--
  Directory.Build.props: wird automatisch von ALLEN Projekten unterhalb
  dieses Ordners gelesen. Die von den Beispielen gemeinsam genutzten Einstellungen stehen daher
  nur einmal hier, statt in jeder .csproj-Datei wiederholt zu werden.
-->
<Project>
  <PropertyGroup>
    <!-- .NET 10, LTS-Version (Long-Term Support) -->
    <TargetFramework>net10.0</TargetFramework>
    <!-- der Compiler meldet die Risiken einer NullReferenceException -->
    <Nullable>enable</Nullable>
    <!-- implizite Usings: System, System.Linq, System.Threading.Tasks... -->
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
</Project>

Gehen wir diese Datei durch:

  • Zeile 9: die Zielversion von [.NET]: [.NET] 10;
  • Zeile 11: „nullable“ Referenztypen. Der Compiler unterscheidet eine Variable vom Typ [string], der niemals der Wert [null] zugewiesen werden darf, von einer Variablen vom Typ [string?], die auf diesen Wert gesetzt werden kann, und gibt bei jedem möglichen Fehler im Zusammenhang mit [NullReferenceException] eine Warnung aus;
  • Zeile 13: Die gebräuchlichsten Namespaces ([System], [System.Linq], [System.Threading.Tasks], [Microsoft.AspNetCore.Builder] ...) werden automatisch in jede Datei importiert: Die entsprechenden [using]-Direktiven müssen nicht geschrieben werden.

Schließlich ist die Datei [appsettings.json] bis Kapitel 8 für alle Beispiele dieselbe:

1
2
3
4
5
6
7
8
9
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}
  • Zeilen 4–5: Protokollierungsstufen. Meldungen der Anwendung werden ab der Stufe [Information] angezeigt; die von [ASP.NET Core] selbst – die sehr zahlreich sind – werden erst ab der Stufe [Warning] angezeigt. Die Konsole zeigt also Startmeldungen und Fehler an, aber nicht die Details jeder Anfrage;
  • Zeile 8: die in Anfragen akzeptierten Domänennamen ([*]: alle).

1.5. Inhalt des Dokuments

Das Dokument ist wie folgt aufgebaut:

Kapitel
Inhalt
Beispiele
Controller, Actions,
Vom Browser zur Action: Routen, Antworten, Weiterleitungen, Services
01 bis 06
Das Action-Modell
Anfrageparameter: Binding, Konvertierung, Validierung, POST-Formulare
07 bis 12
Die View und ihr Modell
Razor, Template, Partial Views, Helper, Formulare, Validierung, PRG
13 bis 21
Internationalisierung
Eine Anwendung auf Französisch und Englisch
22
Datenbereiche
Anwendung, Anfrage, Client
23
Der Lebenszyklus einer Anfrage
Middleware, Autorisierungsfilter, Action-Filter, Exception-Filter, Model Binding
24
Authentifizierung und Autorisierung
JWT in einem Cookie, Rollen, CAPTCHA, Versuchsbegrenzung
25–27
Geschichtete Architektur
Web / Geschäftslogik / DAO mit Entity Framework Core und MySQL
28
Fallstudie
Die Anwendung RdvMedecins, Datei für Datei erklärt
-

Jedes Beispiel führt nur wenige neue Konzepte ein, und die Kapitel bauen aufeinander auf: Am besten lesen Sie sie der Reihe nach. Die Fallstudie greift dagegen auf alle Konzepte der vorangegangenen Kapitel zurück: Wo es sinnvoll ist, verweist ihr Kommentar auf das Beispiel, in dem das Konzept eingeführt wurde.