Projekteinstellungen für C#-Debugkonfigurationen (.NET Core, .NET 5 oder höher und ASP.NET Core)
Debugeinstellungen für ein C#-Projekt können über die Registerkarte „Debuggen“ und die Registerkarte „Erstellen“ der Projekteigenschaftenseiten geändert werden.
Wählen Sie zum Öffnen der Eigenschaftenseiten das Projekt im Projektmappen-Explorer aus, und wählen Sie dann das Symbol Eigenschaften aus, oder klicken Sie mit der rechten Maustaste auf das Projekt und wählen dann Eigenschaften aus.
Weitere Informationen finden Sie unter Debug and release configurations (Debug- und Releasekonfigurationen).
Wichtig
Diese Einstellungen gelten nicht für .NET Framework- oder UWP-Apps. Informationen zum Konfigurieren von Debugeinstellungen für das .NET Framework finden Sie unter Projekteinstellungen für C#-Debugkonfigurationen.
Registerkarte „Debuggen“
Ab Visual Studio 2022 können Sie auf der Registerkarte „Debuggen“ auf Öffnen der Benutzeroberfläche von Debugstartprofilen klicken, um die Benutzeroberfläche für Startprofile zu öffnen und die Debugeinstellungen zu ändern.
Startprofil (.NET Core, .NET 5 oder höher)
| Einstellung | Beschreibung |
|---|---|
| Befehlszeilenargumente | Gibt Befehlszeilenargumente für die App an, die gerade gedebuggt wird. Der Befehlsname entspricht dem unter Externes Programm starten angegebenen App-Namen. |
| Arbeitsverzeichnis | Gibt das Arbeitsverzeichnis der App an, die gerade gedebuggt wird. In C# lautet das Arbeitsverzeichnis standardmäßig \bin\debug. |
| Remotecomputer verwenden | Wählen Sie zum Remotedebuggen diese Option aus, und geben Sie den Namen des Remotedebugziels oder einen Msvsmon-Servernamen ein. Der Speicherort der App auf dem Remotecomputer wird auf der Registerkarte Erstellen mit der Eigenschaft Ausgabepfad festgelegt. Bei diesem Speicherort muss es sich um ein freigegebenes Verzeichnis auf dem Remotecomputer handeln. |
| Umgebungsvariablen | Hiermit werden Umgebungsvariablen festgelegt, bevor der Anwendungsprozess ausgeführt wird. Informationen im Zusammenhang mit ASP.NET Core finden Sie unter Umgebungen. |
| Nicht verwaltetes Codedebuggen aktivieren | Dient zum Debuggen von Aufrufen von nativem (nicht verwaltetem) Win32-Code über die verwaltete App. |
| SQL Server-Debuggen aktivieren | Dient zum Debuggen von SQL Server-Datenbankobjekten. |
| WebView2-Debugging aktivieren | Hiermit wird JavaScript mit dem Microsoft Edge-basierten Debugger (Chromium) debuggt. |
Startprofil (ASP.NET Core)
Zusätzlich zu den Eigenschaften für .NET 5 oder höher enthalten ASP.NET Core-Startprofile mehrere zusätzliche Eigenschaften für die verschiedenen ASP.NET Core-Profile. Diese Einstellungen bieten eine einfache Benutzeroberfläche für die launchSettings.json-Datei des Projekts. Weitere Informationen zu dieser Datei finden Sie im Abschnitt „Entwicklung und die Datei ‘launchSettings.json‘“ unter Verwenden von mehreren Umgebungen in ASP.NET Core.
Die Einstellungen, die auf der Benutzeroberfläche für Startprofile bereitgestellt werden, umfassen Folgendes.
| Einstellung | Beschreibung |
|---|---|
| Browser starten | Wählen Sie aus, ob der Standardbrowser gestartet werden soll, wenn Sie mit dem Debuggen beginnen. Verwenden Sie dazu die URL, die Sie in der URL-Einstellung festgelegt haben. |
| Url | Hiermit wird der Speicherort der Host-URL für .NET oder .NET Core angegeben. Für ein Profil, das nach dem Projekt benannt ist (d. h. die commandName-Eigenschaft in launchSettings.json ist Project), lauscht der Kestrel-Server an dem angegebenen Port. Bei einem IIS-Profil ist dies in der Regel derselbe Wert wie die App-URL. Weitere Informationen finden Sie im Abschnitt „IIS-Startprofil“ unter Konfigurieren des Projekts. |
| URL der App | Hiermit werden die Anwendungs-URLs angegeben. Für ein Profil, das nach dem Projekt benannt ist, gibt diese Eigenschaft die Kestrel-Server-URLs an (in der Regel https://localhost:5001 und http://localhost:5000 ). |
Visual Studio stellt standardmäßig ein IIS Express-Profil zur Verfügung, und Sie können zusätzliche Profile erstellen (z. B. ein IIS-Profil). Diese Einstellungen entsprechen auch den Einstellungen in launchSettings.json. Diese beiden Profiltypen stellen mehrere Einstellungen bereit (z. B. das Hostingmodell).
| Einstellung | BESCHREIBUNG |
|---|---|
| Hostingmodell | Geben Sie „Prozessintern“ (Standard) oder „Prozessextern“ an. Weitere Informationen finden Sie in der ASP.NET Core-Dokumentation im Abschnitt zu den Hostingmodellen. |
| App-SSL-URL | Bei IIS Express lautet die APP-SSL-URL in der Regel http://localhost:44334. |
Registerkarte "Erstellen"
Die folgende Tabelle zeigt Buildeinstellungen, die für das Debuggen nützlich sind. Eine vollständige Erläuterung der Buildeinstellungen finden Sie unter Buildseite, Projekt-Designer.
| Einstellung | Beschreibung |
|---|---|
| Allgemein>Symbole für bedingte Kompilierung | Ist diese Option ausgewählt, werden die Konstanten DEBUG und TRACE definiert. Diese Konstanten ermöglichen das Kompilieren der Debug- und Trace-Klassen. Wenn diese Konstanten definiert sind, generieren die Klassenmethoden „Debug“ und „Trace“ eine Ausgabe im Ausgabefenster. Ohne diese Konstanten werden die Klassenmethoden Debug und Trace nicht kompiliert und keine Ausgabe erzeugt. DEBUG wird in der Regel in der Debugversion eines Builds definiert. Die Definition wird in der Releaseversion wieder aufgehoben. TRACE wird normalerweise sowohl in Debugversionen als auch in Releaseversionen definiert. |
| Allgemein>Code optimieren | Aktivieren Sie diese Einstellung für Debugbuilds nur, wenn ein Fehler ausschließlich in optimiertem Code auftritt. Optimierter Code ist aufwendiger zu debuggen, da die Anweisungen nicht direkt mit den Anweisungen im Quellcode übereinstimmen. |
| Debugsymbole | Gibt den Typ der Debuginformationen an, die vom Compiler generiert werden. Weitere Informationen finden Sie unter Debugsymbole. Informationen zur Konfiguration der Leistung einer Anwendung beim Debuggen finden Sie unter Erleichtern des Debuggens für ein Image. |
| Ausgabe>Basispfad für Ausgabe | Hiermit wird der Basisordner für die Zwischenausgabe angegeben. Bei Debugbuilds erfolgt die Ausgabe in der Regel unter bin\Debug. |
| Ausgabe>Basispfad für Zwischenausgabe | Hiermit wird der Basisordner für die Zwischenausgabe angegeben. Bei Debugbuilds erfolgt die Ausgabe in der Regel unter obj\Debug. |
Debugsymbole
Sie können die folgenden Optionen für Debugsymbole auswählen.
Es wurden keine Symbole ausgegeben
Gibt an, das keine Debuginformationen generiert werden
PDB-Datei, aktuelle Plattform
Hiermit wird eine PDB-Datei generiert, d. h. eine plattformspezifische Symboldatei, die anderen Tools, besonders Debuggern, Informationen über die Erstellung und den Inhalt der wichtigsten ausführbaren Datei bereitstellt.
PDB-Datei, portierbar
Erzeugt eine PDB-Datei, d.h. eine nicht plattformspezifische Symboldatei, die anderen Tools, besonders Debuggern, Informationen über die Erstellung und den Inhalt der wichtigsten ausführbaren Datei bereitstellt. Weitere Informationen finden Sie unter Portable PDB.
Eingebettet in DLL/EXE, plattformübergreifend portierbar
Portable Symbolinformationen werden in der Assembly eingebettet. Es wird keine externe PDB-Datei generiert.
Weitere Informationen finden Sie unter /debug (C# Compiler Options).