2. Einrichtung der Entwicklungsumgebung
2008 installierten wir Visual C# 2008 Express, das das .NET-3.5-Framework, das DBMS SQL Compact Server und die MSDN-Dokumentation enthielt, und erstellten Projekte anschließend mit grafischen Assistenten. Heute besteht die Entwicklungsumgebung aus zwei voneinander unabhängigen Komponenten:
- das .NET SDK („Software Development Kit“): der Compiler, die Laufzeitplattform, die Bibliotheken und der Befehl [dotnet], mit dem sich alles über die Befehlszeile erledigen lässt (ein Programm erstellen, kompilieren, ausführen, testen und veröffentlichen);
- ein Editor oder eine IDE (integrierte Entwicklungsumgebung): [VS Code] mit der Erweiterung [C# Dev Kit], oder [Visual Studio 2026], oder [JetBrains Rider]. Der Editor setzt auf dem SDK auf.
Dieses Dokument verwendet für alle Operationen den Befehl [dotnet]: Er funktioniert unter Windows, Linux und macOS gleich, unabhängig vom gewählten Editor.
2.1. .NET 10 SDK
2.1.1. Installation
Das .NET 10 SDK kann von https://dotnet.microsoft.com/download/dotnet/10.0 heruntergeladen werden. Unter Windows können Sie es auch über ein Terminal (PowerShell oder Eingabeaufforderung) mit dem Paketmanager [winget] installieren:
Sie müssen das SDK (das alles enthält) auswählen und nicht nur die „Runtime“ (die nur das Ausführen vorkompilierter Programme erlaubt). Unter Linux ist das SDK in den Repositories der großen Distributionen verfügbar (zum Beispiel [sudo apt install dotnet-sdk-10.0] unter Ubuntu; je nach Version der Distribution müssen Sie vorher eventuell das in der Installationsdokumentation von Microsoft angegebene Repository hinzufügen).
Öffnen Sie nach der Installation ein neues Terminal, um zu prüfen, ob der Befehl [dotnet] verfügbar ist und die Version des SDK anzeigt:
Der Befehl [dotnet --list-sdks] listet die installierten SDK-Versionen auf (mehrere Versionen können nebeneinander existieren):
Die genaue Version (hier [10.0.112]) hängt vom Installationsdatum ab: Microsoft veröffentlicht jeden Monat ein Hotfix-Update. Alle Versionen des SDK 10.0.x sind für dieses Dokument geeignet. Der Befehl [dotnet --info] liefert ausführlichere Informationen (Betriebssystem, Speicherort des SDK, Versionen der installierten Laufzeitplattformen).
2.1.2. Der Befehl dotnet
Der Befehl [dotnet] umfasst viele Unterbefehle. Hier sind diejenigen, die wir verwenden werden:
Befehl | Rolle |
[dotnet run file.cs] | kompiliert und führt eine Einzeldatei-Anwendung aus |
[dotnet new console -n Name] | erstellt ein Konsolenprojekt im Ordner [Name] (weitere Vorlagen: [classlib], [mstest], [web] …) |
[dotnet build] | kompiliert das Projekt im aktuellen Ordner |
[dotnet run] | kompiliert (falls nötig) und führt das Projekt im aktuellen Ordner aus |
[dotnet test] | führt die Unit-Tests aus (Kapitel 6) |
[dotnet new sln] | erstellt eine Projektmappe (eine Datei, die mehrere Projekte zusammenfasst) |
[dotnet sln add Project] | fügt der Projektmappe ein Projekt hinzu |
[dotnet add package Name] | fügt dem Projekt eine NuGet-Bibliothek hinzu (Kapitel 10 und 11) |
[dotnet add reference ../Other] | fügt einen Verweis auf ein anderes Projekt hinzu (Kapitel 6) |
[dotnet publish] | bereitet das Programm für die Bereitstellung vor |
Bibliotheken, die nicht Teil der Plattform sind, werden als NuGet-Pakete verteilt, von https://www.nuget.org heruntergeladen und auf dem Computer im Ordner [%USERPROFILE%\.nuget\packages] abgelegt. 2008 kopierten wir die DLL-Dateien der Bibliotheken (Spring.NET, NUnit und den MySQL-Konnektor) in einen Ordner [lib] innerhalb des Projekts; heute deklariert das Projekt die benötigten Pakete, und der Befehl [dotnet] lädt sie herunter.
2.2. Der Editor
2.2.1. VS Code
VS Code ist ein kostenloser, plattformübergreifender Editor. Um in C# zu programmieren, fügen Sie die Erweiterung C# Dev Kit von Microsoft hinzu (Menü „Extensions“ öffnen und nach „C# Dev Kit“ suchen), die auch die Erweiterung C# installiert. Sie bietet:
- Syntaxhervorhebung, Codevervollständigung und Hilfe per Tooltip;
- Fehlererkennung während der Eingabe;
- Code-Navigation (F12: Go to Definition);
- einen Projektmappen-Explorer (Ansicht „Solution Explorer“);
- Ausführung und Debugging (F5);
- Ausführung von Unit-Tests (Ansicht „Testing“).
Öffnen Sie in VS Code den Ordner mit den Programmen („File / Open Folder“), zum Beispiel den Ordner [csharp-oct-2026] mit den Beispielen dieses Dokuments. Im integrierten Terminal („Terminal / New Terminal“) können Sie [dotnet]-Befehle eingeben, ohne den Editor zu verlassen.
2.2.2. Visual Studio 2026
Unter Windows bevorzugen Sie möglicherweise Visual Studio 2026, den Nachfolger von Visual Studio 2008, das im ursprünglichen Kurs verwendet wurde. Die Edition Community ist für Privatpersonen, Bildungseinrichtungen und Open-Source-Projekte kostenlos. Installieren Sie sie von https://visualstudio.microsoft.com und wählen Sie dabei die Workload „.NET Desktop Development“ (und „ASP.NET and web development“ für Kapitel 13) aus. Visual Studio öffnet die [.slnx]-Projektmappen und [.csproj]-Projekte der Beispiele direkt („File / Open / Project/Solution“) und führt sie mit [Ctrl-F5] (ohne Debugging) oder [F5] (mit Debugging) aus, genau wie 2008.
Eine dritte Möglichkeit ist JetBrains Rider, das für nicht kommerzielle Nutzung kostenlos ist.
Im weiteren Verlauf dieses Dokuments werden die Schritte mit dem Befehl [dotnet] beschrieben, der unabhängig vom Editor dieselben Ergebnisse liefert.
2.3. Ein erstes Programm: eine Einzeldatei-Anwendung
2.3.1. Das Programm
Ab .NET 10 kann ein C#-Programm aus einer einzigen [.cs]-Datei ohne Projektdatei bestehen. Man spricht von einer „dateibasierten App“. Erstellen wir die folgende Datei [hello.cs]:
und führen sie aus:
Kommentare:
- Zeile 1: ein Kommentar. Alles nach [//] bis zum Zeilenende wird vom Compiler ignoriert;
- Zeile 2: die einzige Anweisung des Programms: Sie gibt eine Textzeile auf dem Bildschirm aus. Das Programm hat weder eine Klasse noch eine Methode namens [Main], anders als sein Gegenstück von 2008; in Kapitel 3 werden wir sehen, dass der Compiler sie selbst erzeugt;
- Der Befehl [dotnet run hello.cs] kompiliert das Programm und führt es anschließend aus. Die erste Ausführung dauert einige Sekunden; spätere Ausführungen erfolgen fast sofort, solange die Datei unverändert bleibt, da das Kompilierergebnis in einem Cache gespeichert wird.
Einzeldatei-Anwendungen eignen sich für kleine Programme, und wir werden sie für die meisten Beispiele verwenden. Einige Direktiven am Anfang der Datei erlauben es, sie ohne Projektdatei zu erstellen:
- die Direktive [#:package] fügt eine NuGet-Bibliothek hinzu (Kapitel 10);
- die Direktive [#:property] legt eine Kompilierungseigenschaft fest (Kapitel 5);
- die Direktive [#:sdk] wählt ein anderes SDK aus, etwa das für Webanwendungen (Kapitel 12);
Wenn unter Windows [.cs]-Dateien als UTF-8 gespeichert werden (was in VS Code der Standard ist), werden Umlaute und andere Sonderzeichen im Terminal korrekt angezeigt.
2.3.2. Eine Einzeldatei-Anwendung in ein Projekt umwandeln
Wächst eine Einzeldatei-Anwendung (mehrere Dateien, Tests, Verweise auf andere Projekte), wird sie in ein Projekt umgewandelt:
Der Befehl erstellt einen Ordner namens [hello] , der eine Kopie des Programms und eine Projektdatei namens [hello.csproj] enthält:
Die Projektdatei übernimmt die Standardeigenschaften von Einzeldatei-Anwendungen (zum Beispiel [PublishAot], das die Vorab-Kompilierung in nativen Code vorbereitet). Nicht benötigte Eigenschaften können Sie entfernen. Wir betrachten die Projekte nun genauer.
2.4. Ein Konsolenprojekt
2.4.1. Das Projekt erstellen
Ein Projekt ist ein Ordner, der eine Projektdatei ([.csproj]) und Quelldateien enthält. Es wird mit dem Befehl [dotnet new] erstellt, gefolgt vom Namen einer Vorlage (hier [console], eine Konsolenanwendung):
Der Befehl hat einen Ordner namens [FirstProgram] mit zwei Dateien erstellt. Die Projektdatei [FirstProgram.csproj] sieht so aus:
- Zeile 1: Das Projekt verwendet das SDK [Microsoft.NET.Sdk], das für Konsolenanwendungen und Bibliotheken;
- Zeile 4: Das Projekt erzeugt eine ausführbare Datei ([Exe]) und keine Bibliothek;
- Zeile 5: Die Zielplattform ist .NET 10 ([net10.0]);
- Zeile 6: Die gebräuchlichsten Namespaces ([System], [System.IO], [System.Linq] …) werden automatisch in alle Dateien importiert (Kapitel 3);
- Zeile 7: Der Compiler prüft die Verwendung von Null-Referenzen und gibt Warnungen zu möglichen Fehlern aus (Kapitel 3 und 4).
Die Datei von 2008 beschrieb auf etwa hundert Zeilen jede Quelldatei des Projekts, die Bibliotheksverweise und die Konfigurationen Debug/Release. Die heutige Projektdatei enthält nur die Einstellungen, die von den Standardwerten abweichen: Alle [.cs]-Dateien im Ordner gehören zum Projekt.
Wir ersetzen den Inhalt der generierten Datei [Program.cs] durch Folgendes:
2.4.2. Kompilierung und Ausführung
Der im Projektordner eingegebene Befehl [dotnet build] kompiliert das Projekt:
- Zeile 2: Der Befehl beginnt mit der Wiederherstellung des Projekts, d. h. dem Herunterladen der NuGet-Pakete, von denen es abhängt (hier gibt es keine);
- Zeile 4: Das Ergebnis der Kompilierung ist eine DLL, die Datei [FirstProgram.dll] im Ordner [bin/Debug/net10.0] des Projekts. Unter Windows ist der angezeigte Pfad ein Windows-Pfad ([bin\Debug\net10.0\FirstProgram.dll]).
Der Ordner [bin/Debug/net10.0] enthält dann die folgenden Dateien:
- [FirstProgram.dll] enthält den kompilierten Code (im Zwischencode IL);
- [FirstProgram] (unter Windows [FirstProgram.exe]) ist ein kleiner Starter, der die Plattform .NET startet und sie die DLL ausführen lässt;
- [FirstProgram.pdb] enthält die vom Debugger verwendeten Informationen;
- die beiden [.json]-Dateien beschreiben die Abhängigkeiten des Programms und die zu seiner Ausführung erforderliche Version von .NET.
Sie können den Starter direkt ausführen:
Am häufigsten wird jedoch der Befehl [dotnet run] verwendet; er kompiliert das Projekt bei Bedarf und führt es anschließend aus:
Wie 2008 gibt es zwei Build-Konfigurationen: Debug (Standard, mit Debuginformationen) und Release (optimiert, für den Produktivbetrieb), ausgewählt mit der Option [-c Release]: [dotnet build -c Release] erzeugt das Programm im Ordner [bin/Release/net10.0]. Der Ordner [obj] enthält Zwischendateien der Kompilierung. Die Ordner [bin] und [obj] können Sie bedenkenlos löschen: Sie werden bei der nächsten Kompilierung neu erstellt.
2.5. Eine Projektmappe mit mehreren Projekten
2.5.1. Die Projektmappe erstellen
Eine Projektmappe fasst mehrere Projekte zusammen. Sie ermöglicht es, diese gemeinsam im Editor zu öffnen und gemeinsam zu kompilieren. Erstellen wir eine Projektmappe in dem Ordner, der das Projekt [FirstProgram] enthält:
und fügen wir dann das Projekt hinzu:
Fügen wir ein zweites Projekt hinzu, [TwoHands], dessen Inhalt wir weiter unten betrachten:
Der Befehl [dotnet sln list] listet die Projekte der Projektmappe auf:
Die Projektmappendatei [02-installation.slnx] sieht so aus:
Das ist eine sehr einfache XML-Datei. Seit .NET 10 ist dies das Standardformat für Projektmappen ([.slnx]). Das alte Format [.sln], das in Visual Studio 2008 verwendet wurde, war deutlich umfangreicher; es findet sich noch in bestehenden Projekten, und mit dem Befehl [dotnet new sln --format sln] kann es weiterhin erstellt werden.
Im Ordner der Projektmappe kompiliert der Befehl [dotnet build] alle Projekte der Projektmappe. Um ein bestimmtes Projekt auszuführen, wechseln Sie in dessen Ordner und geben [dotnet run] ein oder verwenden die Option [--project]: [dotnet run --project FirstProgram].
2.5.2. Ein Projekt mit mehreren Main-Methoden
Der Kurs von 2008 zeigte, dass ein Projekt mehrere Klassen enthalten kann, jede mit einer statischen Methode namens [Main], und dass man angeben muss, welche ausgeführt werden soll. Das ist weiterhin möglich. Das Projekt [TwoHands] enthält zwei Klassen. Die Klasse [P1]:
und die Klasse [P2]:
Kompiliert man das Projekt ohne weitere Vorkehrungen, erhält man einen Fehler:
Der Compiler weiß nicht, welche Methode [Main] der Einstiegspunkt des Programms ist. Wir legen dies in der Projektdatei mit der Eigenschaft [StartupObject] fest:
- Zeile 9: Die ausgeführte Methode [Main] gehört zur Klasse [TwoHands.P2] (dem vollständigen Klassennamen einschließlich des Namespace).
Ergebnisse:
Mit Top-Level-Anweisungen (Kapitel 3) stellt sich die Frage nicht mehr: Eine einzige Datei im Projekt kann sie enthalten, und diese Datei dient als Einstiegspunkt.
2.6. Beispiele in diesem Dokument
So führen Sie die Beispiele in diesem Dokument aus:
- Laden Sie den Ordner [csharp-oct-2026] herunter (Link am Anfang des Dokuments);
- öffnen Sie ihn in VS Code („File / Open Folder“) oder, für ein bestimmtes Kapitel, öffnen Sie die Projektmappe des Kapitels ([.slnx]) in Visual Studio;
- führen Sie in einem Terminal im Ordner eines Kapitels eine Einzeldatei-Anwendung mit [dotnet run name.cs] aus, oder ein Projekt mit [dotnet run] im Projektordner.
Die Kapitel 10 und 11 verwenden eine MySQL-Datenbank; die Installation von MySQL mit [Laragon] ist im Anhang beschrieben.