|
|
Raise (Método)
Genera un error en tiempo de ejecución.
Sintaxis
objeto.Raise number, source, description, helpfile, helpcontext
El método Raise tiene el calificador de objeto y los argumentos con nombre siguientes:
| Argumento | Descripción |
|---|---|
| objeto | Requerido. Siempre el objeto Err. |
| number | Requerido. Entero de tipo Long que identifica la naturaleza del error. Los errores de Visual Basic (tanto los definidos por Visual Basic como los definidos por el usuario) se encuentran entre 0 y 65535. El intervalo de 0 a 512 está reservado para errores del sistema; el intervalo 513 a 65535 está disponible para errores definidos por el usuario. Al establecer en la propiedad Number su propio código de error en un módulo de clase, agrega su código de error a la constante vbObjectError. Por ejemplo, para generar el número de error 513, asigne vbObjectError +513 a la propiedad Number. |
| source | Opcional. Expresión de cadena que indica el objeto o la aplicación que generó el error. Al establecer esta propiedad para un objeto, use el formato proyecto.clase. Si no especifica nada, se utilizará el identificador programático del proyecto de Visual Basic actual. |
| description | Opcional. Expresión de cadena que describe el error. Si no se especifica, se examina el valor de Number. Si se corresponde con un código de error en tiempo de ejecución de Visual Basic, se utiliza para Description la cadena que devolvería la función Error. Si no hay correspondencia con ningún error de Visual Basic, en Number se utiliza "Error definido por la aplicación o el objeto". |
| helpfile | Opcional. Ruta reconocida del archivo de Ayuda en el que se encuentra la información sobre el error. Si no se especifica, Visual Basic utilizará la unidad, ruta y nombre reconocidos del archivo de Ayuda de Visual Basic. |
| helpcontext | Opcional. Identificador de contexto que especifica el tema del archivo indicado en HelpFile que contiene la información de ayuda del error. Si se omite, se utilizará el identificador de contexto del archivo de Ayuda de Visual Basic correspondiente al valor de la propiedad Number, si tal identificador existe. |
Comentarios
Todos los argumentos son opcionales, excepto number. Sin embargo, si utiliza Raise sin especificar algunos argumentos, y los valores de las propiedades del objeto Err no se han borrado, dichos valores se conservarán para el error actual.
Raise se utiliza para generar errores en tiempo de ejecución y puede usarse en lugar de la instrucción Error. Raise es útil para generar errores al escribir módulos de clase, ya que el objeto Err proporciona más información de la que ofrecen los errores generados con la instrucción Error. Por ejemplo, con el método Raise puede especificarse el origen del error en la propiedad Source, puede invocar Ayuda en pantalla sobre el error, etc.