Configuración de proyecto para la depuración de C# (.NET Core, .NET 5+ y ASP.NET Core)
Puede cambiar la configuración de depuración de los proyectos en C# en la pestaña Depurar y la pestaña Compilar de las páginas de propiedades del proyecto.
Para abrir las páginas de propiedades, seleccione el proyecto en el Explorador de soluciones y, luego, elija el icono de Propiedades o haga clic con el botón derecho en el proyecto y seleccione Propiedades.
Para obtener más información, vea Configuraciones Debug y Release.
Importante
Esta configuración no se aplica a las aplicaciones de .NET Framework o UWP. Para configurar las opciones de depuración .NET Framework, consulte Configuración de proyecto para opciones de depuración de C#.
Pestaña Depurar
A partir de Visual Studio 2022, elija Abrir la UI de perfiles de inicio de depuración en la pestaña Depurar para abrir la interfaz de usuario de los perfiles de inicio y cambiar la configuración de depuración.
Perfil de inicio (.NET Core, .NET 5+)
| Configuración | Descripción |
|---|---|
| Argumentos de la línea de comandos | Especifica los argumentos de la línea de comandos de la aplicación que se va a depurar. El nombre de comando es el nombre de la aplicación especificado en Programa externo de inicio. |
| Directorio de trabajo | Especifica el directorio de trabajo de la aplicación que se depura. En C# , el directorio de trabajo es \bin\debug de forma predeterminada. |
| Usar máquina remota | Para la depuración remota, seleccione esta opción y escriba el nombre del destino de depuración remota o un nombre de servidor de msvsmon. La ubicación de una aplicación en la maquina remota se especifica mediante la propiedad Ruta de acceso de resultados, en la pestaña Compilar. La ubicación debe ser un directorio que se pueda compartir en el equipo remoto. |
| Variables de entorno | Establece las variables de entorno antes de ejecutar el proceso de aplicación. Para ASP.NET Core, vea Entornos. |
| Habilitar depuración de código no administrado | Depura las llamadas a código Win32 nativo (no administrado) desde la aplicación administrada. |
| Habilitar depuración de SQL Server | Depura los objetos de base de datos de SQL Server. |
| Habilitación de la depuración de WebView2 | Depura JavaScript con un depurador basado en Microsoft Edge (Chromium). |
Perfil de inicio (ASP.NET Core)
Además de las propiedades de .NET 5+, los perfiles de inicio de ASP.NET Core incluyen varias propiedades adicionales para los distintos perfiles de ASP.NET Core. Esta configuración proporciona una interfaz de usuario sencilla para el archivo launchSettings.json del proyecto. Para obtener más información sobre este archivo, consulte la sección Desarrollo y aunchSettings.json en Usar varios entornos en ASP.NET Core.
La configuración proporcionada en la interfaz de usuario de los perfiles de inicio incluye lo siguiente.
| Configuración | Descripción |
|---|---|
| Iniciar el explorador | Seleccione si desea iniciar el explorador predeterminado al iniciar la depuración, con la dirección URL establecida en la configuración URL. |
| Url | Especifica la ubicación de la dirección URL del host para .NET o .NET Core. Para un perfil que tenga el mismo nombre que el proyecto (es decir, la propiedad commandName en launchSettings.json es Project), el servidor Kestrel escucha el puerto especificado. Para un perfil de IIS, suele ser el mismo valor que la dirección URL de la aplicación. Para obtener más información, vea la sección Perfil de inicio de IIS en Configurar el proyecto. |
| Dirección URL de la aplicación | Especifica la URL de la aplicación. Para un perfil que tenga el mismo nombre que el proyecto, esta propiedad especifica las direcciones URL del servidor Kestrel, normalmente https://localhost:5001 y http://localhost:5000 |
Visual Studio proporciona un perfil IIS Express de forma predeterminada, y puede crear perfiles adicionales, como un perfil de IIS. Esta configuración también corresponde a la configuración de launchSettings.json. Estos dos tipos de perfil proporcionan varias configuraciones, como el modelo de hospedaje.
| Configuración | Descripción |
|---|---|
| Modelo de alojamiento | Especifique En curso (valor predeterminado) o Fuera de proceso. Para obtener más información, vea Modelos de hospedaje en la documentación de ASP.NET Core. |
| URL del certificado SSL de la aplicación | Para IIS Express, la dirección URL de SSL de la aplicación suele ser http://localhost:44334.. |
Pestaña Compilar
En la tabla siguiente se muestran las opciones de configuración de compilación que son útiles para la depuración. Para obtener una explicación completa de la configuración de compilación, consulte Página de compilación, Diseñador de proyectos.
| Configuración | Descripción |
|---|---|
| General>Símbolos de compilación condicional | Define las constantes DEBUG y TRACE si se selecciona. Estas constantes permiten la compilación condicional de Debug (clase) y Trace (clase). Con la definición de estas constantes, los métodos de clase Debug y Trace generan resultados en la ventana Salida. Sin estas constantes, los métodos de clase Debug y Trace no se compilan y no se generan resultados. Normalmente, DEBUG se define en la versión de depuración de una compilación y no se define en la versión de lanzamiento. TRACE se define en las versiones de lanzamiento y de depuración. |
| General>Optimizar código | A menos que un error aparezca solo en el código optimizado, deje esta opción desactivada para las compilaciones de depuración. El código optimizado es más difícil de depurar, puesto que las instrucciones no se corresponden directamente con las instrucciones del código fuente. |
| Símbolos de depuración | Especifica el tipo de información de depuración generado por el compilador. Consulte Símbolos de depuración. Para obtener información sobre cómo configurar el rendimiento de depuración de una aplicación, consulte Facilitar la depuración de una imagen. |
| Salida>Ruta de acceso de la salida base | Especifica la carpeta base para la salida intermedia. La salida suele ir a bin\Debug para una compilación de depuración. |
| Salida>Ruta de acceso de salida intermedia base | Especifica la carpeta base para la salida intermedia. La salida suele ir a obj\Debug para una compilación de depuración. |
Símbolos de depuración
Puede elegir las siguientes opciones para los símbolos de depuración.
No se emitió ningún símbolo
Especifica que no se generará ninguna información de depuración.
Archivo PDB, plataforma actual
Genera un archivo .PDB, un archivo de símbolos específico de plataforma que proporciona a otras herramientas, especialmente depuradores, información sobre qué se encuentra en el archivo ejecutable principal y cómo se ha generado.
Archivo PDB, portátil
Genera un archivo .PDB, un archivo de símbolos portátil no específico de plataforma que proporciona a otras herramientas, especialmente depuradores, información sobre qué se encuentra en el archivo ejecutable principal y cómo se ha generado. Vea PDB portátil para obtener más información.
Incrustado en DLL/EXE, portable en distintas plataformas
Inserta información de símbolos portátil en el ensamblado. No se genera ningún archivo .PDB externo.
Para obtener más información, consulte /debug (Opciones del compilador de C#).