Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können die C#-Projektdebugeinstellungen in der Registerkarte Debug und in der Registerkarte Build auf den Projekteigenschaftenseiten ändern.
Um die Eigenschaftenseiten zu öffnen, wählen Sie 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 Sie Eigenschaftenaus.
Weitere Informationen finden Sie unter Debug- und Releasekonfigurationen.
Wichtig
Diese Einstellungen gelten nicht für .NET Framework- oder UWP-Apps. Informationen zum Konfigurieren von Debugeinstellungen für .NET Framework finden Sie unter Project-Einstellungen für C#-Debugkonfigurationen.
Registerkarte „Debuggen“
Ab Visual Studio 2022 können Sie auf der Registerkarte „Debuggen“ die Option Öffnen der Benutzeroberfläche von Debugstartprofilen auswählen, 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 zu debuggende App an. Der Befehlsname ist der in Start externe Programmangegebene App-Name. |
| Arbeitsverzeichnis | Gibt das Arbeitsverzeichnis der zu debuggenden App an. In C# ist das Arbeitsverzeichnis standardmäßig \bin\debug. |
| Remote-Computer verwenden | Wählen Sie für das Remotedebugging diese Option aus, und geben Sie den Namen des Remotedebuggingziels oder einen Msvsmon-Servernamenein. Der Speicherort einer App auf dem Remotecomputer wird durch die eigenschaft Output Path auf der Registerkarte Build angegeben. Der Speicherort muss ein gemeinsam nutzbares Verzeichnis auf dem Remotecomputer sein. |
| Umgebungsvariablen | Legt Umgebungsvariablen fest, bevor der Anwendungsprozess ausgeführt wird. Informationen zu ASP.NET Core finden Sie unter Environments. |
| Debuggen von nicht verwaltetem Code aktivieren | Führt Debugging von Aufrufen zu nativem (nicht verwaltetem) Win32-Code aus der verwalteten App durch. |
| Aktivieren des SQL Server-Debuggings | Führt das Debugging von SQL-Server-Datenbankobjekten durch. |
| WebView2-Debugging- aktivieren | Debuggt JavaScript mit einem auf Microsoft Edge (Chromium) basierenden Debugger. |
Startprofil (ASP.NET Core)
Zusätzlich zu den Eigenschaften für .NET 5+ enthalten ASP.NET Core-Startprofile mehrere zusätzliche Eigenschaften für die verschiedenen ASP.NET Core-Profile. Diese Einstellungen stellen eine einfache Benutzeroberfläche für die launchSettings.json Datei des Projekts bereit. Weitere Informationen zu dieser Datei finden Sie im Abschnitt "Entwicklung und launchSettings.json" in Verwenden mehrerer Umgebungen in ASP.NET Core.
Die in der Benutzeroberfläche für Startprofile bereitgestellten Einstellungen umfassen Folgendes.
| Einstellung | Beschreibung |
|---|---|
| Browser starten | Wählen Sie aus, ob der Standardbrowser beim Starten des Debuggings gestartet werden soll, indem Sie die URL verwenden, die Sie in der Einstellung URL festgelegt haben. |
| URL | Gibt den Speicherort der Host-URL für .NET oder .NET Core an. Für ein Profil, das nach dem Projekt benannt ist (d. h. die commandName-Eigenschaft in launchSettings.json ist Project), lauscht der Kestrel-Server auf den 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. |
| App-URL | Gibt die Anwendungs-URL(n) an. 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 bereit, und Sie können zusätzliche Profile wie ein IIS-Profil erstellen. Diese Einstellungen entsprechen auch einstellungen in launchSettings.json. Diese beiden Profiltypen stellen verschiedene Einstellungen bereit, z. B. das Hostingmodell.
| Einstellung | Beschreibung |
|---|---|
| Hostingmodell | Geben Sie "In Process" (Standardeinstellung) oder "Out of Process" an. Weitere Informationen finden Sie unter Hostingmodelle in den ASP.NET Core-Dokumenten. |
| App-SSL-URL | Für IIS Express ist die SSL-URL der App in der Regel http://localhost:44334. |
Registerkarte "Erstellen"
In der folgenden Tabelle sind Buildeinstellungen aufgeführt, die für das Debuggen nützlich sind. Eine vollständige Erläuterung der Buildeinstellungen finden Sie unter Seite „Erstellen“, Projekt-Designer.
| Einstellung | Beschreibung |
|---|---|
| Allgemein>Symbole für bedingte Kompilierung | Definieren Sie die DEBUG- und TRACE-Konstanten, wenn diese ausgewählt sind. Diese Konstanten ermöglichen die bedingte Kompilierung der Debugklasse und Trace-Klasse. Wenn diese Konstanten definiert sind, generieren die Methoden der Debug- und Trace-Klasse im Ausgabefenster eine Ausgabe. Ohne diese Konstanten werden debug- und Trace-Klassenmethoden nicht kompiliert, und es wird keine Ausgabe generiert. In der Regel wird DEBUG in der Debugversion eines Builds definiert und in der Releaseversion nicht definiert. TRACE wird sowohl in der Debug- als auch in der Release-Version definiert. |
| Allgemein>Code optimieren | Es sei denn, ein Fehler tritt nur im optimierten Code auf, lassen Sie diese Einstellung für Debug-Builds deaktiviert. Optimierter Code ist schwieriger zu debuggen, da Anweisungen nicht direkt anweisungen im Quellcode entsprechen. |
| Debugsymbole | Gibt den Typ der vom Compiler generierten Debuginformationen an. Weitere Informationen finden Sie unter Debugsymbole. Informationen zum Konfigurieren der Debugging-Einstellungen einer Anwendung finden Sie unter Wie man das Debuggen eines Image erleichtert. |
| Ausgabe>Basispfad für Ausgabe | Gibt den Basisordner für die Zwischenausgabe an. Die Ausgabe wird typischerweise in bin\Debug bei einem Debug-Build gespeichert. |
| Ausgabe>Basispfad für Zwischenausgabe | Gibt den Basisordner für die Zwischenausgabe an. Bei einem Debugbuild erfolgt die Ausgabe in der Regel unter obj\Debug. |
Debugsymbole
Sie können die folgenden Optionen für Debugsymbole auswählen.
Keine Symbole werden ausgesendet
Gibt an, dass keine Debuginformationen generiert werden.
PDB-Datei, aktuelle Plattform
Erzeugt eine .PDB-Datei, eine plattformspezifische Symboldatei, die anderen Tools, insbesondere Debuggern, Informationen darüber liefert, was in der Hauptprogrammdatei enthalten ist und wie sie erstellt wurde.
PDB-Datei, portable
Erzeugt ein . PDB-Datei, eine nicht plattformspezifische, portable Symboldatei, die andere Tools bereitstellt, insbesondere Debugger, Informationen darüber, was in der Hauptdatei der ausführbaren Datei enthalten ist und wie sie erstellt wurde. Weitere Informationen finden Sie in Portable PDB.
Eingebettet in DLL/EXE, portierbar über Plattformen
Portierbare Symbolinformationen werden in der Assembly eingebettet. Kein externer . PDB-Datei wird erstellt.
Weitere Informationen finden Sie unter /debug (C#-Compileroptionen).