Interceptación de errores con Visual Basic para Aplicaciones

Cuando se produce un error en tiempo de ejecución en una macro de Microsoft Visual Basic para Aplicaciones, aparece un mensaje de error en la pantalla y la macro se detiene o se comporta de forma imprevisible.

Para evitar que la aplicación se bloquee o se comporte de forma imprevisible, puede incluir código de macro que intercepte el error e indique a la macro cómo debe controlarlo. El proceso de interceptar y controlar un error en tiempo de ejecución se denomina "interceptación de errores". El conjunto de instrucciones que indica a la aplicación cómo controlar el error se denomina "rutina de control de errores" o "controlador de errores".

Microsoft proporciona ejemplos de programación con fines ilustrativos únicamente, sin ninguna garantía, ya sea expresa o implícita. Esto incluye, entre otras, las garantías implícitas de comerciabilidad e idoneidad para un fin determinado. En este artículo se da por supuesto que ya conoce el lenguaje de programación que se muestra, así como las herramientas empleadas para crear y depurar procedimientos. Los ingenieros de soporte técnico de Microsoft pueden explicarle la funcionalidad de un determinado procedimiento, pero no modificarán estos ejemplos para ofrecer mayor funcionalidad ni crearán procedimientos adaptados a sus necesidades específicas. Mientras el código de Visual Basic se está ejecutando, puede encontrar varios tipos de errores que se pueden interceptar. Puede aprovechar la interceptación de errores de Microsoft Excel si utiliza las funciones e instrucciones siguientes.

Instrucción On Error

La instrucción On Error hace que Visual Basic para Aplicaciones empiece o deje de interceptar errores. La instrucción On Error también especifica un conjunto de instrucciones que se ejecutarán si se encuentra un error.

Para obtener información adicional al respecto, consulte los artículos siguientes en Microsoft Knowledge Base:

Función Err

La función Err devuelve el número del error encontrado.

Ejemplo de uso de la función Err: La tabla siguiente contiene una lista de los códigos de error interceptables que puede encontrarse al utilizar la función Err. Para obtener información adicional al respecto, consulte el artículo siguiente en Microsoft Knowledge Base:

Función Error

La función Error devuelve el mensaje de error correspondiente a un número de error determinado.

Ejemplo de uso de la función Error:

Instrucción Error

La instrucción Error simula la aparición de un error permitiéndole asignar un número de error personalizado a la función Err. Estos valores de error definidos por el usuario son valores que usted define para sus procedimientos y que siempre se almacenan en variables del tipo de datos Variant. Un uso frecuente de este tipo de valor de error es en los procedimientos que aceptan varios argumentos y devuelven un valor. Por ejemplo, suponga que el valor devuelto sólo es válido si los argumentos quedan dentro de un cierto intervalo. Su procedimiento puede probar los argumentos que el usuario proporciona y, si los argumentos no están en el intervalo aceptable, puede hacer que el procedimiento devuelva el valor de error adecuado.

Error es un subtipo del tipo de datos Variant y cuando se utiliza el término "valor de error", normalmente significa que una variable es del tipo Variant y que contiene un valor que Visual Basic para Aplicaciones reconoce como un error definido por el usuario. Los valores de error se utilizan en un procedimiento para indicar que se han producido condiciones de error. A diferencia de los errores normales en tiempo de ejecución, estos errores no interrumpen el código porque se reconocen como variables normales y no como errores. Sus procedimientos pueden comprobar estos valores de error y realizar las acciones correctivas adecuadas.

También puede utilizar la instrucción Error para simular errores en tiempo de ejecución. Esto es especialmente útil cuando está probando aplicaciones o cuando desea tratar una condición determinada como equivalente a un error en tiempo de ejecución. Es posible simular cualquier error en tiempo de ejecución de Visual Basic para Aplicaciones proporcionando el código para el error en una instrucción Error. También puede utilizar la instrucción Error para crear sus propios errores definidos por el usuario proporcionando un código de error que no corresponda a un error en tiempo de ejecución de Visual Basic para Aplicaciones. Anteriormente en este artículo se incluye una tabla que contiene una lista de los errores integrados (bajo la sección "Función Err"). Ahora, Visual Basic para Aplicaciones no utiliza todos los números disponibles para los errores integrados. En futuras versiones de Visual Basic para Aplicaciones aumentarán los números internos a medida que se agreguen más errores integrados. Se recomienda que empiece sus números de error en 50000 y que avance hasta 65535 para evitar posibles conflictos en el futuro.

Ejemplo de uso de la instrucción Error para simular errores en tiempo de ejecución: Cuando se ejecute la macro Test, recibirá un cuadro de mensajes que contendrá "ocurrió mi propio error" como mensaje.

Función CVErr

La función CVErr se utiliza para crear valores de error. La función CVErr toma un argumento que debe ser un entero o una variable que contenga un entero. Ejemplo de uso de la función CVErr:

Utilizar valores de error integrados

Hay siete valores de error integrados en Microsoft Excel. En la tabla siguiente se muestra el número de error (constante), el valor de error literal y el valor de error convertido. El trabajo con estos valores de error de hoja de cálculo integrados se realiza de la misma forma que con los errores definidos por el usuario: como números convertidos en valores de error mediante la función CVErr. La única diferencia es que para los errores de hoja de cálculo, Visual Basic para Aplicaciones proporciona los números de error como constantes integradas y también proporciona valores de error literales. Estos elementos no se proporcionan para los valores de error definidos por el usuario. Los valores de error literales deben especificarse entre corchetes como se muestra en la tabla anterior.

Ejemplo de uso de valores de error integrados:

Centralizar el código de control de errores

Cuando agregue código de control de errores a sus macros de Visual Basic para Aplicaciones, descubrirá que se controlan los mismos errores una y otra vez. Puede reducir el tamaño del código y el esfuerzo necesario para escribir código si escribe algunos procedimientos a los que el código de control de errores pueda llamar para controlar las situaciones de error frecuentes.

A continuación se ofrece un ejemplo de un procedimiento de función que muestra un mensaje correspondiente al error que se ha producido y, donde sea posible, permite al usuario especificar qué acción se realizará a continuación eligiendo un botón determinado. Después devuelve el número del código al procedimiento que lo llamó.

Controlar interrupciones por parte del usuario

Un usuario puede interrumpir un procedimiento de Visual Basic para Aplicaciones si presiona CTRL+INTER o ESC (COMANDO+PUNTO en Macintosh). Es posible deshabilitar las interrupciones para los procedimientos en las aplicaciones terminadas. Sin embargo, si no deshabilita las interrupciones por parte del usuario en el procedimiento terminado, puede asegurarse de que se notifica al procedimiento cuándo se ha producido una interrupción para que pueda cerrar los archivos, desconectarse de los recursos compartidos o restaurar las variables modificadas antes de devolver el control de la aplicación al usuario.

Puede interceptar las interrupciones por parte del usuario en sus procedimientos si establece la propiedad EnableCancelKey en xlErrorHandler. Cuando esta propiedad está establecida, todas las interrupciones generarán un error en tiempo de ejecución número 18, que se puede interceptar mediante una instrucción On Error. Puede controlar el error para detener el procedimiento y salir del programa. Si se utiliza la instrucción Resume para continuar con el procedimiento después de un error en tiempo de ejecución interceptado, se omitirá la interrupción.

También es posible omitir completamente las interrupciones por parte del usuario si se establece la propiedad EnableCancelKey en xlDisabled. En este estado, Microsoft Excel pasa por alto todos los intentos por parte del usuario para interrumpir el procedimiento en ejecución. Para restaurar el procesamiento de interrupciones predeterminado, cambie la configuración de la propiedad EnableCancelKey a xlInterrupt. Para impedir que un procedimiento deshabilite permanentemente las interrupciones por parte del usuario, Microsoft Excel restaura siempre la configuración predeterminada de la propiedad EnableCancelKey a xlInterrupt cada vez que el procedimiento finaliza su ejecución. Para garantizar que las interrupciones se controlan correctamente dentro del código, debe deshabilitar explícitamente o interceptar las interrupciones cada vez que se ejecute el procedimiento. Hay que destacar que sólo puede utilizarse un controlador de interrupciones para cada procedimiento y que se utiliza el mismo controlador para todos los errores en tiempo de ejecución encontrados por ese procedimiento.

En el ejemplo siguiente se muestra un procedimiento que necesita mucho tiempo para completarse. Si un usuario interrumpe el procedimiento, se interceptará un error. La interrupción por parte del usuario confirma primero que realmente se debe detener el procedimiento y a continuación sale del procedimiento de manera ordenada. Si ejecuta la macro ProcessData y presiona rápidamente CTRL+INTER, aparecerá un cuadro de mensajes que le preguntará si desea dejar de procesar registros. Si hace clic en Sí, aparecerá otro cuadro de mensajes con el texto "Se produjo una interrupción por parte del usuario". Si hace clic en Aceptar en este cuadro de mensajes, la macro terminará. Si hace clic en No en el primer cuadro de mensajes, la macro continuará.

Instrucción Resume

La instrucción Resume reanuda la ejecución del código una vez que haya finalizado una rutina de control de errores.

Excel 97

Para obtener más información acerca de cómo interceptar errores de macro, haga clic en la ficha Índice en la Ayuda de Visual Basic para Microsoft Excel 97, escriba el texto y haga doble clic en el texto seleccionado para ir al tema "Errores interceptables".

Excel 7.0

Para obtener más información acerca de cómo interceptar errores de macro, haga clic en la ficha Índice en la Ayuda de Microsoft Excel 7.0, escriba el texto y haga doble clic en el texto seleccionado para ir al tema "Interceptación de errores".

Excel 5.0

En el capítulo 9, "Control de errores y valores de error", del "Manual del usuario de Visual Basic", versión 5.0, consulte los temas siguientes:

• "Impedir que el código se detenga o actúe de forma imprevisible"
• "Crear valores de error que no interrumpan el código"
• "Utilizar los valores de error integrados de Microsoft Excel"
• "Técnicas avanzadas de control de errores"