Editar y continuar (Visual C#)

Con Recarga activa o Editar y continuar para C#, puede realizar cambios en el código en modo de interrupción o ejecución mientras depura. Los cambios pueden aplicarse sin necesidad de detener y reiniciar la sesión de depuración.

La experiencia básica de Recarga activa funciona con la mayoría de los tipos de aplicaciones .NET y versiones de marco. Se incluyen .NET Framework, .NET Core y .NET 5+ (para C# y Visual Basic, según corresponda). La expectativa en este escenario es que, si se usa el depurador, hay que suponer que Recarga activa está disponible para usted y pruébalo.

Recarga activa admite la mayoría de los cambios que podría realizar durante una sesión de depuración, pero existen algunas excepciones. Por ejemplo, la Recarga activa no es compatible con el código optimizado ni las sesiones de depuración con el depurador administrado y nativo habilitado.

Para obtener información sobre otros escenarios no admitidos, vea Cambios de código admitidos (C# y Visual Basic). Si intenta aplicar cambios de código con uno de estos escenarios, aparece un cuadro de mensaje que indica que no se admite la Recarga activa.

Usar Recarga activa

En C#, Recarga activa se ejecuta automáticamente cuando se realizan cambios en modo de interrupción y, después, se continúa la depuración mediante Continuar, Paso o Establecer instrucción siguiente. Si establece Recarga activa en el archivo guardado en true, también se ejecutará automáticamente al guardar un archivo.

Para habilitar o deshabilitar la Recarga activa:

  1. Si está en una sesión de depuración, detenga la depuración (Depurar>Detener depuración o Mayús+F5).

  2. Abra Herramientas>Opciones>Depuración>Recarga activa de .NET/C++, active o desactive la casilla Habilitar Recarga activa y Editar y continuar al depurar.

La configuración tendrá efecto cuando se inicie o reinicie la sesión de depuración.

Para usar la experiencia clásica Editar y continuar:

  1. Durante la depuración, en el modo de interrupción, realice un cambio en el código fuente.

  2. En el menú Depurar, haga clic en Continuar, Paso o Establecer instrucción siguiente. La depuración continúa con el nuevo código compilado.

La opción Editar y continuar no admite algunos tipos de cambios del código. Para obtener más información, vea Cambios de código admitidos (C# y Visual Basic).

Con Editar y continuar para C#, puede realizar cambios en el código en modo de interrupción o ejecución mientras depura. Los cambios pueden aplicarse sin necesidad de detener y reiniciar la sesión de depuración. En modo de ejecución, el editor de código fuente es de solo lectura.

Editar y continuar es compatible con UWP en Windows 10 versiones posteriores, así como aplicaciones x86 y x64 que tienen como destino el escritorio de .NET Framework 4.6 o versiones posteriores (.NET Framework es solo una versión de escritorio).

Editar y continuar admite la mayoría de los cambios que podría realizar durante una sesión de depuración, pero existen algunas excepciones. Editar y continuar no se admite para el código de integración optimizado, mixto o de SQL Server Common Language Runtime (CLR). Para obtener información sobre otros escenarios no admitidos, vea Cambios de código admitidos (C# y Visual Basic). Si prueba Editar y continuar con uno de estos escenarios, aparecerá un cuadro de mensaje en el que se indica que no se admite.

Para obtener información sobre otros escenarios no admitidos, vea Cambios de código admitidos (C# y Visual Basic). Si intenta aplicar cambios de código con uno de estos escenarios, aparece un cuadro de mensaje que indica que no se admite la Recarga activa.

Usar Editar y continuar

En C#, Editar y continuar se ejecuta automáticamente cuando se realizan cambios en modo de interrupción y, después, se continúa la depuración mediante Continuar, Paso o Establecer instrucción siguiente, o bien se evalúa una función en una ventana del depurador.

Para habilitar o deshabilitar Editar y continuar:

  1. Si está en una sesión de depuración, detenga la depuración (Depurar>Detener depuración o Mayús+F5).

  2. En Herramientas>Opciones (o Depurar>Opciones) >Depuración>General, active o desactive la casilla Habilitar Editar y continuar.

La configuración tendrá efecto cuando se inicie o reinicie la sesión de depuración.

Para usar Editar y continuar:

  1. Durante la depuración, en el modo de interrupción, realice un cambio en el código fuente.

  2. En el menú Depurar, haga clic en Continuar, Paso o Establecer instrucción siguiente o evalúe una función en una ventana del depurador.

    La depuración continúa con el nuevo código compilado.

La opción Editar y continuar no admite algunos tipos de cambios del código. Para obtener más información, vea Cambios de código admitidos (C# y Visual Basic).