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 explorador de soluciones y, a continuación, seleccione el icono 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 aplicaciones de .NET Framework ni para UWP. Para configurar las opciones de depuración .NET Framework, consulte Configuración de proyecto para opciones de depuración de C#.
Ficha 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+)
| Ajuste | 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 del comando es el nombre de la aplicación especificado en Iniciar programa externo. |
| directorio de trabajo | Especifica el directorio de trabajo de la aplicación que se depura. En C#, el directorio de trabajo se \bin\debug de forma predeterminada. |
| Usar la 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 compartible en la máquina remota. |
| variables de entorno | Establece 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 llamadas a código Win32 nativo (no administrado) desde la aplicación administrada. |
| Habilitar depuración de SQL Server | Depura objetos de base de datos de SQL Server. |
| Habilitación de la depuración de WebView2 | Depura JavaScript con el depurador basado en Microsoft Edge (Chromium). |
Perfil de inicio (ASP.NET Core)
Además de las propiedades de .NET 5+, los perfiles de lanzamiento 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 launchSettings.json en Uso de varios entornos en ASP.NET Core.
La configuración proporcionada en la interfaz de usuario de perfiles de inicio incluye lo siguiente.
| Ajuste | Descripción |
|---|---|
| Abrir navegador | Seleccione si desea iniciar el navegador predeterminado cuando inicie la depuración, usando la URL establecida en la configuración de 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, consulte la sección Perfil de inicio de IIS en Configurar el proyecto. |
| URL de la aplicación | Especifica las direcciones URL de la aplicación. Para un perfil que lleva el nombre del proyecto, esta propiedad especifica las direcciones URL del servidor Kestrel, normalmente https://localhost:5001 y http://localhost:5000. |
Visual Studio proporciona un perfil de IIS Express de forma predeterminada y puede crear perfiles adicionales, como un perfil de IIS. Esta configuración también se corresponde con la configuración de launchSettings.json. Estos dos tipos de perfil proporcionan varias opciones de configuración, como el modelo de hospedaje.
| Ajuste | Descripción |
|---|---|
| Modelo de hospedaje | Especifique En proceso (valor predeterminado) o Fuera del 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, vea Página de compilación, Diseñador de proyectos.
| Ajuste | Descripción |
|---|---|
| General>símbolos de compilación condicional | Defina las constantes DEBUG y TRACE si está seleccionada. Estas constantes habilitan la compilación condicional de la clase de depuración y la clase Trace . Con estas constantes definidas, los métodos de la clase Debug y Trace generan resultados en la ventana de Salida . Sin estas constantes, los métodos de clase Debug y Trace no se compilan y no se genera ninguna salida. 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 Debug y Release. |
| general>Optimizar código | A menos que aparezca un error solo en el código optimizado, deje esta configuración deseleccionada para las compilaciones de depuración. El código optimizado es más difícil de depurar, ya 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 generada 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 Hacer que una imagen sea más fácil de depurar. |
| 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 emiten símbolos
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 la plataforma que proporciona a otras herramientas, especialmente depuradores, información sobre lo que se encuentra en el archivo ejecutable principal y cómo se produjo.
Archivo PDB, portátil
Genera un archivo .PDB, un archivo de símbolos portátil que no es específico de ninguna plataforma y que proporciona a otras herramientas, especialmente a los depuradores, información sobre el contenido del archivo ejecutable principal y cómo se produjo. Consulte PDB portable para obtener más información.
Insertado en DLL/EXE, portátil entre plataformas
Inserta información de símbolos portátil en el ensamblado. No se produce ningún archivo .PDB externo.
Para obtener más información, vea /debug (Opciones del compilador de C#).