Opciones generales de depuraciónGeneral debugging options

Para establecer las opciones del depurador de Visual Studio, seleccione herramientas > opcionesy en depuración Active o desactive las casillas junto a la General opciones.To set Visual Studio debugger options, select Tools > Options, and under Debugging select or deselect the boxes next to the General options. Puede restaurar toda la configuración predeterminada con herramientas > importar y exportar configuraciones > restablecer todas las configuraciones.You can restore all default settings with Tools > Import and Export Settings > Reset all settings. Para restablecer un subconjunto de valores, guarde la configuración con la importar y exportar configuraciones antes de realizar los cambios que se va a probar, a continuación, importar la configuración guardada más adelante.To reset a subset of settings, save your settings with the Import and Export Settings Wizard before making the changes that you want to test, then import your saved settings afterward.

Puede establecer las siguientes General opciones:You can set the following General options:

Preguntar antes de eliminar todos los puntos de interrupción: Requiere confirmación antes de ejecutar el comando Eliminar todos los puntos de interrupción.Ask before deleting all breakpoints: Requires confirmation before completing the Delete All Breakpoints command.

Interrumpir todos los procesos cuando se interrumpa uno: Interrumpe simultáneamente todos los procesos a los que está asociado el depurador cuando se produce una interrupción.Break all processes when one process breaks: Simultaneously breaks all processes to which the debugger is attached, when a break occurs.

Interrumpir cuando las excepciones crucen AppDomain o los límites administrados o nativos: En la depuración administrada o en modo mixto, Common Language Runtime puede capturar excepciones que atraviesen los límites del dominio de aplicación o los límites administrados o nativos, cuando se cumplen las siguientes condiciones:Break when exceptions cross AppDomain or managed/native boundaries: In managed or mixed-mode debugging, the common language runtime can catch exceptions that cross application domain boundaries or managed/native boundaries when the following conditions are true:

  1. Cuando el código nativo llama al código administrado utilizando la interoperabilidad COM y el código administrado produce una excepción.When native code calls managed code by using COM Interop and the managed code throws an exception. Consulte Introducción a la interoperabilidad COM.See Introduction to COM Interop.

  2. Cuando el código administrado que se ejecuta en el dominio de aplicación 1 llama al código administrado en el dominio de aplicación 2 y este último produce una excepción.When managed code running in application domain 1 calls managed code in application domain 2, and the code in application domain 2 throws an exception. Consulte Programar con dominios de aplicación.See Programming with application domains.

  3. Cuando el código llama una función mediante la reflexión y que la función produce una excepción.When code calls a function by using reflection, and that function throws an exception. Consulte reflexión.See Reflection.

En condiciones de 2 y 3, a veces detecta la excepción mediante código administrado en mscorlib en lugar de por common language runtime.In conditions 2 and 3, the exception is sometimes caught by managed code in mscorlib rather than by the common language runtime. Esta opción no afecta a la interrupción en excepciones detectadas por mscorlib.This option does not affect breaking on exceptions caught by mscorlib.

Habilitar la depuración de nivel de dirección: Habilita las características avanzadas para la depuración en el nivel de dirección (ventana Desensamblado, ventana Registros y puntos de interrupción de dirección).Enable address-level debugging: Enables advanced features for debugging at the address level (the Disassembly window, the Registers window, and address breakpoints).

  • Mostrar desensamblado si el código fuente no está disponible: Muestra automáticamente el desensamblado ventana cuando se depura código para el que el origen está disponible.Show disassembly if source is not available: Automatically shows the Disassembly window when you debug code for which the source is unavailable.

Habilitar filtros de puntos de interrupción: Permite establecer filtros en puntos de interrupción, de manera que solo afecten a procesos, subprocesos o equipos concretos.Enable breakpoint filters: Enables you to set filters on breakpoints so that they will affect only specific processes, threads, or computers.

Usar el nuevo asistente de excepciones: Permite que la aplicación auxiliar de excepciones que reemplaza al Asistente de excepciones.Use the new Exception Helper: Enables the Exception Helper that replaces the exception assistant. (Aplicación auxiliar de excepciones se admite a partir de Visual Studio 2017)(Exception Helper is supported starting in Visual Studio 2017)

Note

Para código administrado, esta opción se denominaba anteriormente habilitar el Asistente de excepciones .For managed code, this option was previously called Enable the exception assistant .

Habilite Solo mi código: El depurador solo muestra y accede al código de usuario ("Mi código"), y pasa por alto el código de sistema u otro código optimizado o que no tenga símbolos de depuración.Enable Just My Code: The debugger displays and steps into user code ("My Code") only, ignoring system code and other code that is optimized or that does not have debugging symbols.

  • Advertir de la inexistencia de código de usuario al iniciar (solo administrado): Cuando se inicia la depuración con la opción Solo mi código habilitada, esta opción le advierte si no hay código de usuario ("Mi código").Warn if no user code on launch (Managed only): When debugging starts with Just My Code enabled, this option warns you if there is no user code ("My Code").

Habilitar ejecución paso a paso de código fuente de .NET Framework: Permite al depurador ejecutar paso a paso el código fuente de .NET Framework.Enable .NET Framework source stepping: Allows the debugger to step into .NET Framework source. Al habilitar esta opción deshabilita automáticamente solo mi código.Enabling this option automatically disables Just My Code. Símbolos de .NET framework se descargarán a una ubicación de caché..NET Framework symbols will be downloaded to a cache location. Cambiar la ubicación de caché con la opciones cuadro de diálogo, depuración categoría, símbolos página.Change the cache location with the Options dialog box, Debugging category, Symbols page.

Saltar propiedades y operadores (solo administrado): Impide que el depurador ejecute paso a paso las propiedades y operadores en código administrado.Step over properties and operators (Managed only): Prevents the debugger from stepping into properties and operators in managed code.

Habilitar evaluación de propiedades y otras llamadas a función implícitas: Activa la evaluación automática de propiedades y de llamadas a funciones implícitas en ventanas de variables y en el cuadro de diálogo Inspección rápida.Enable property evaluation and other implicit function calls: Turns on automatic evaluation of properties and implicit function calls in variables windows and the QuickWatch dialog box.

  • Llamar a la función de conversión de cadenas en objetos de ventanas de variables (solo C# y JavaScript): Ejecuta una llamada de conversión de cadena implícita al evaluar objetos en ventanas de variables.Call string conversion function on objects in variables windows (C# and JavaScript only): Executes an implicit string conversion call when evaluating objects in variables windows. El resultado se muestra como una cadena en lugar del nombre de tipo.The result is displayed as a string instead of the type name. Solo se aplica mientras se lleva a cabo la depuración en código C#.Only applies while debugging in C# code. Este valor puede reemplazarse por el atributo DebuggerDisplay (consulte utilizando el atributo DebuggerDisplay).This setting may be overridden by the DebuggerDisplay attribute (see Using the DebuggerDisplay attribute).

Habilitar compatibilidad de servidor de origen: Indica al depurador de Visual Studio que obtenga los archivos de código fuente de los servidores de origen que implementan el protocolo SrcSrv (srcsrv.dll).Enable source server support: Tells the Visual Studio debugger to get source files from source servers that implement the SrcSrv (srcsrv.dll) protocol. Team Foundation Server y las herramientas de depuración para Windows son dos servidores de origen que implementan el protocolo.Team Foundation Server and the Debugging Tools for Windows are two source servers that implement the protocol. Para obtener más información sobre la configuración de SrcSrv, vea el SrcSrv documentación.For more information about SrcSrv setup, see the SrcSrv documentation. Además, consulte especificar archivos de código fuente y símbolos (.pdb).In addition, see Specify symbol (.pdb) and source files.

Important

Dado que la lectura de archivos .pdb puede ejecutar código arbitrario en los archivos, asegúrese de que el servidor es de confianza.Because reading .pdb files can execute arbitrary code in the files, make sure that you trust the server.

  • Imprimir los mensajes de diagnóstico del servidor de origen en la ventana de salida: Cuando se habilita la compatibilidad del servidor de origen, esta configuración activa la presentación de información de diagnóstico.Print source server diagnostic messages to the Output window: When source server support is enabled, this setting turns on diagnostic display.

  • Permitir servidor de origen para ensamblados de confianza parcial (solo administrado): Cuando la compatibilidad del servidor de origen está habilitada, esta configuración invalida el comportamiento predeterminado de no recuperar los orígenes de los ensamblados de confianza parcial.Allow source server for partial trust assemblies (Managed only): When source server support is enabled, this setting overrides the default behavior of not retrieving sources for partial trust assemblies.

  • Ejecutar siempre los comandos del servidor de origen que no sean de confianza sin preguntar: Cuando se habilita la compatibilidad del servidor de origen, esta configuración invalida el comportamiento predeterminado de preguntar al ejecutar un comando que no se confía.Always run untrusted source server commands without prompting: When source server support is enabled, this setting overrides the default behavior of prompting when running an untrusted command.

Habilitar compatibilidad con vínculos de origen: Indica al depurador de Visual Studio para descargar los archivos de origen para .pdb archivos que contienen información de vínculo de origen.Enable Source Link support: Tells the Visual Studio debugger to download source files for .pdb files that contain Source Link information. Para obtener más información sobre el vínculo de origen, consulte el especificación de vinculación de código fuente.For more information about Source Link, see the Source link specification.

Important

Como origen de vínculo descargará los archivos mediante http o https, asegúrese de que confía el .pdb archivo.Because Source Link will download files using http or https, make sure you trust the .pdb file.

  • Recurrir a la autenticación del Administrador de credenciales de GIT para todas las solicitudes de vínculos de origen: Cuando se habilita la compatibilidad de vínculo de origen y una solicitud de vínculo de origen se produce un error de autenticación, Visual Studio, a continuación, llama al administrador de credenciales de Git.Fall back to Git Credential Manager authentication for all Source Link requests: When Source Link support is enabled, and a Source Link request fails authentication, Visual Studio then calls the Git Credential Manager.

Resaltar la línea de puntos de interrupción y la instrucción actual (solo C++): Cuando el depurador resalta un punto de interrupción o la instrucción actual, resalta toda la línea.Highlight entire line for breakpoints and current statement (C++ only): When the debugger highlights a breakpoint or current statement, it highlights the entire line.

Es necesario que los archivos de código fuente coincidan con la versión original: Indica al depurador que compruebe que un archivo de código fuente coincide con la versión del código fuente utilizada para compilar el archivo ejecutable que se está depurando.Require source files to exactly match the original version: Tells the debugger to verify that a source file matches the version of the source code used to build the executable you are debugging. Cuando la versión no coincide, se le pedirá que busque un origen correspondiente.When the version does not match, you're prompted to find a matching source. Si no se encuentra este archivo, el código fuente no se mostrará durante la depuración.If a matching source is not found, the source code will not be displayed during debugging.

Redirigir el texto de la ventana de salida a la ventana Inmediato: Envía a la ventana Inmediato todos los mensajes del depurador que normalmente irían a la ventana Salida.Redirect all Output window text to the Immediate window: Sends all debugger messages that would ordinarily appear in the Output window to the Immediate window instead.

Mostrar la estructura de los objetos en ventanas de variables: Desactiva todas las personalizaciones de vistas de estructuras de objetos.Show raw structure of objects in variables windows: Turns off all object structure view customizations. Para obtener más información acerca de las personalizaciones de vistas, consulte crear vistas personalizadas de objetos administrados.For more information about view customizations, see Create custom views of .managed objects.

Suprimir optimización JIT al cargar el módulo (únicamente administrado): Deshabilita la optimización JIT de código administrado cuando se carga un módulo con compilación JIT mientras se asocia el depurador.Suppress JIT optimization on module load (Managed only): Disables the JIT optimization of managed code when a module is loaded and JIT is compiled while the debugger is attached. Al deshabilitar la optimización se puede simplificar la depuración de algunos problemas, aunque el rendimiento se verá afectado.Disabling optimization may make it easier to debug some problems, although at the expense of performance. Si se utiliza Solo mi código, suprimir la optimización JIT puede hacer que el código que no sea de usuario aparezca como código de usuario ("Mi código").If you are using Just My Code, suppressing JIT optimization can cause non-user code to appear as user code ("My Code"). Para obtener más información, consulte JIT optimización y depuración.For more information, see JIT optimization and debugging.

Habilitar depuración de JavaScript para ASP.NET (IE, Microsoft Edge y Chrome): Permite al depurador de script para las aplicaciones ASP.NET.Enable JavaScript debugging for ASP.NET (Chrome, Edge, and IE): Enables the script debugger for ASP.NET apps. En el primer uso en Chrome, debe iniciar sesión en el explorador para habilitar las extensiones de Chrome que ha instalado.On first use in Chrome, you may need to sign into the browser to enable Chrome extensions that you have installed. Deshabilitar esta opción para revertir al comportamiento heredado.Disable this option to revert to legacy behavior.

Habilitar herramientas de desarrollo de Microsoft Edge para aplicaciones JavaScript UWP (experimental): Permite que herramientas de desarrollo para aplicaciones UWP JavaScript en Edge.Enable Edge Developer Tools for UWP JavaScript Apps (Experimental): Enables developer tools for UWP JavaScript apps in Edge.

Habilitar el depurador de JavaScript de Chrome heredado para ASP.NET: Permite al depurador de script de JavaScript de Chrome heredado para las aplicaciones ASP.NET.Enable legacy Chrome JavaScript debugger for ASP.NET: Enables the legacy Chrome JavaScript script debugger for ASP.NET apps. En el primer uso en Chrome, debe iniciar sesión en el explorador para habilitar las extensiones de Chrome que ha instalado.On first use in Chrome, you may need to sign into the browser to enable Chrome extensions that you have installed.

Usar el modo experimental para iniciar la depuración de JavaScript de Chrome cuando se ejecuta Visual Studio como administrador: Indica a Visual Studio para probar una nueva forma de iniciar Chrome durante la depuración de JavaScript.Use experimental way to launch Chrome JavaScript debugging when running Visual Studio as Administrator: Tells Visual Studio to try a new way to launch Chrome during JavaScript debugging.

Cargar exportaciones de dll (solo nativas): Carga las tablas de exportación de archivos DLL.Load dll exports (Native only): Loads dll export tables. La información de símbolos de las tablas de exportación de archivos DLL puede resultar útil si se trabaja con mensajes de Windows, procedimientos de Windows (WindowProc), objetos COM, cálculo de referencias o cualquier archivo DLL para el que no disponga de símbolos.Symbol information from dll export tables can be useful if you are working with Windows messages, Windows procedures (WindowProcs), COM objects, or marshaling, or any dll for which you do not have symbols. La lectura de la información de exportación de archivos DLL implica cierta sobrecarga.Reading dll export information involves some overhead. Por lo tanto, esta funcionalidad está desactivada de forma predeterminada.Therefore, this capability is turned off by default.

Para ver los símbolos que están disponibles en la tabla de exportación de un archivo DLL, utilice dumpbin /exports.To see what symbols are available in the export table of a dll, use dumpbin /exports. Los símbolos están disponibles para cualquier archivo DLL de sistema de 32 bits.Symbols are available for any 32-bit system dll. Si lee el resultado de dumpbin /exports , podrá ver el nombre exacto de la función, incluidos los caracteres no alfanuméricos.By reading the dumpbin /exports output, you can see the exact function name, including non-alphanumeric characters. Esto resulta útil para establecer un punto de interrupción en una función.This is useful for setting a breakpoint on a function. Los nombres de función procedentes de tablas de exportación de archivos DLL pueden aparecer truncados en otras partes del depurador.Function names from dll export tables might appear truncated elsewhere in the debugger. Las llamadas se muestran en una lista según el orden de llamada, y la función actual (la que está anidada a mayor profundidad) aparece en la parte superior.The calls are listed in the calling order, with the current function (the most deeply nested) at the top. Para obtener más información, vea dumpbin /exports.For more information, see dumpbin /exports.

Mostrar diagrama de pilas paralelas en orden ascendente: Controla la dirección en la que las pilas se muestran en la ventana Pilas paralelas.Show parallel stacks diagram bottom-up: Controls the direction in which stacks are displayed in the Parallel Stacks window.

Omitir las excepciones de acceso a la memoria de GPU si los datos escritos no modificaron el valor: Omite las condiciones de carrera que se detectaron durante la depuración si los datos no cambiaron.Ignore GPU memory access exceptions if the data written didn't change the value: Ignores race conditions that were detected during debugging if the data didn't change. Para obtener más información, consulte depurar código de GPU.For more information, see Debugging GPU Code.

Usar modo de compatibilidad administrado: Reemplaza el motor de depuración predeterminado por una versión heredada para habilitar estos escenarios:Use Managed Compatibility Mode: Replaces the default debugging engine with a legacy version to enable these scenarios:

  • Se utiliza un lenguaje .NET Framework distinto de C#, Visual Basic, o F# que proporciona su propio evaluador de expresiones (incluido C++ / c++ / CLI).You are using a .NET Framework language other than C#, Visual Basic, or F# that provides its own Expression Evaluator (this includes C++/CLI).

  • Desea habilitar editar y continuar para proyectos de C++ durante la depuración en modo mixto.You want to enable Edit and Continue for C++ projects during mixed mode debugging.

Note

Elección de compatibilidad administrado modo deshabilitan algunas características que solo están implementadas en el motor de depuración predeterminado.Choosing Managed Compatibility mode disables some features that are implemented only in the default debugging engine. El motor de depuración heredado se ha sustituido en Visual Studio 2012.The legacy debugging engine was replaced in Visual Studio 2012.

Usar los evaluadores de expresiones de C# y VB heredados: El depurador utilizará Visual Studio 2013 C# o evaluadores de expresión de Visual Basic en lugar de los evaluadores de expresión basados en Roslyn de Visual Studio 2015.Use the legacy C# and VB expression evaluators: The debugger will use the Visual Studio 2013 C# or Visual Basic expression evaluators rather than the Visual Studio 2015 Roslyn-based expression evaluators.

Al usar visualizadores del depurador personalizados, advertir de procesos potencialmente no seguros (solo administrados): Visual Studio le advierte cuando se usa un visualizador del depurador personalizado que ejecuta código en el proceso de depuración, dado que podría ejecutar código no seguro.Warn when using custom debugger visualizers against potentially unsafe processes (Managed only): Visual Studio warns you when you are using a custom debugger visualizer that is running code in the debugged process, because it could be running unsafe code.

Habilitar asignador de montón de depuración de Windows (solo nativo): Habilita el montón de depuración de Windows para mejorar los diagnósticos del montón.Enable Windows debug heap allocator (Native only): Enables the windows debug heap to improve heap diagnostics. Habilitar esta opción afectará al rendimiento de la depuración.Enabling this option will impact debugging performance.

Habilitar las herramientas de depuración de interfaz de usuario para XAML: Aparecerán las ventanas Árbol visual dinámico y Explorador de propiedades dinámico al iniciar la depuración (F5) de un tipo de proyecto compatible.Enable UI Debugging Tools for XAML: The Live Visual Tree and the Live Property Explore windows will appear when you start debugging (F5) a supported project type. Para obtener más información, consulte propiedades XAML inspeccionar durante la depuración.For more information, see Inspect XAML properties while debugging.

  • Obtener una vista previa de los elementos seleccionados en el árbol visual dinámico: También se selecciona en el árbol visual dinámico el elemento XAML cuyo contexto está seleccionado.Preview selected elements in Live Visual Tree: The XAML element whose context is selected is also selected in the Live Visual Tree window.

  • Mostrar herramientas de runtime en la aplicación: Muestra el Live Visual Tree comandos en una barra de herramientas en la ventana principal de la aplicación XAML que se está depurando.Show runtime tools in application: Shows the Live Visual Tree commands in a toolbar on the main window of the XAML application that is being debugged. Esta opción se introdujo en Visual Studio 2015 Update 2.This option was introduced in Visual Studio 2015 Update 2.

  • Habilitar Editar y continuar para XAML: Permite usar la edición y seguir la función con el código XAML.Enable XAML Edit and Continue: Allows you to use the Edit and Continue feature with XAML code.

Habilitar herramientas de diagnóstico durante la depuración: Durante la depuración, se abre la ventana de Herramientas de diagnóstico.Enable Diagnostic Tools while debugging: The Diagnostic Tools window appears while you are debugging.

Mostrar PerfTip de tiempo transcurrido durante la depuración: La ventana de código muestra el tiempo transcurrido de una determinada llamada de método durante la depuración.Show elapsed time PerfTip while debugging: The code window displays the elapsed time of a given method call when you are debugging.

Habilitar Editar y continuar: Habilita la funcionalidad de editar y continuar durante la depuración.Enable Edit and Continue: Enables the Edit and Continue functionality while debugging.

  • Habilitar la opción Editar y continuar nativa: Puede usar la función Editar y continuar durante la depuración de código nativo de C++.Enable Native Edit and Continue: You can use the Edit and Continue functionality while debugging native C++ code. Para obtener más información, consulte editar y continuar (Visual C++).For more information, see Edit and Continue (Visual C++).

  • Aplicar cambios al continuar (solo nativo): Al continuar el proceso desde un estado de interrupción, Visual Studio compila y aplica los cambios de código pendientes realizados automáticamente.Apply changes on continue (Native only): Visual Studio automatically compiles and applies any outstanding code changes you have made when continuing the process from a break state. Si no está seleccionada, puede aplicar los cambios con el elemento Aplicar cambios en el código en el menú Depurar.If not selected, you can choose to apply changes using the Apply Code Changes item under the Debug menu.

  • Advertir sobre el código obsoleto (solo nativo): Obtenga advertencias sobre código obsoleto.Warn about stale code (Native only): Get warnings about stale code.

Mostrar la ejecución, haga clic en botón en el editor mientras se depura: Cuando se selecciona esta opción, el hacer clic y ejecutar botón se mostrará durante la depuración.Show Run to Click button in editor while debugging: When this option is selected, the Run to Click button will be shown while debugging.

Cerrar la consola automáticamente al detenerse la depuración: Indica a Visual Studio para cerrar la consola al final de una sesión de depuración.Automatically close the console when debugging stops: Tells Visual Studio to close the console at the end of a debugging session.

Opciones disponibles en versiones anteriores de Visual StudioOptions available in older versions of Visual Studio

Si usa una versión anterior de Visual Studio, podrían encontrarse con algunas opciones adicionales.If you're using an older version of Visual Studio, some additional options might be present.

Habilitar el Asistente de excepciones: Para código administrado, permite que el Asistente de excepciones.Enable the exception assistant: For managed code, enables the exception assistant. A partir de Visual Studio 2017, la aplicación auxiliar de excepciones reemplaza al Asistente de excepciones.Starting in Visual Studio 2017, the Exception Helper replaced the exception assistant.

Desenredar la pila de llamadas cuando se produzcan excepciones no controladas: Hace que la ventana Pila de llamadas revierta la pila de llamadas hasta el punto anterior en el que se produjo la excepción no controlada.Unwind the call stack on unhandled exceptions: Causes the Call Stack window to roll back the call stack to the point before the unhandled exception occurred.

Advertir de la inexistencia de símbolos al iniciar (solo nativo): Muestra un cuadro de diálogo de advertencia cuando se depura un programa para que el depurador no tiene ninguna información de símbolos.Warn if no symbols on launch (native only): Displays a warning dialog box when you debug a program for which the debugger has no symbol information.

Avisar si la depuración de scripts está deshabilitada al inicio: Se muestra un cuadro de diálogo de advertencia cuando el depurador se inicia con la depuración de scripts deshabilitada.Warn if script debugging is disabled on launch: Displays a warning dialog box when the debugger is launched with script debugging disabled.

Usar modo de compatibilidad nativa: Cuando se selecciona esta opción, el depurador usa el depurador nativo de Visual Studio 2010 en lugar del nuevo depurador nativo.Use Native Compatibility Mode: When this option is selected, the debugger uses the Visual Studio 2010 native debugger instead of the new native debugger.

  • Use esta opción cuando esté depurando código C++. NET, ya que el nuevo motor de depuración no admite evaluar expresiones de C++. NET.Use this option when you are debugging .NET C++ code, because the new debugging engine does not support evaluating .NET C++ expressions. Sin embargo, habilitar el modo de compatibilidad nativa deshabilita muchas características que dependen de la implementación actual del depurador para funcionar.However, enabling Native Compatibility Mode disables many features that depend on the current debugger implementation to operate. Por ejemplo, el motor heredado carece de muchos visualizadores para tipos integrados como std::string en proyectos de Visual Studio 2015.For example, the legacy engine lacks many visualizers for built-in types like std::string in Visual Studio 2015 projects. Usar proyectos de Visual Studio 2013 para la experiencia de depuración óptima en estos casos.Use Visual Studio 2013 projects for the optimal debugging experience in these cases.

Vea tambiénSee also