Método Raise

Genera un error en tiempo de ejecución.

Sintaxis

objeto . Aumentarnúmero, origen, descripción, archivo de ayuda, helpcontext

El método Raise tiene el siguiente calificador de objeto y argumentos con nombre:

Argumento	Descripción
object	Obligatorio. Siempre el objeto Err .
number	Obligatorio. Entero Long que identifica la naturaleza del error. Los errores de Visual Basic (los errores definidos por el usuario y definidos por Visual Basic) se encuentran en el rango 0–65535. El rango 0–512 se reserva para errores del sistema; el rango 513–65535 está disponible para errores definidos por el usuario. Al establecer la propiedad Number en su propio código de error en un módulo de clase, agregue el número de código de error a la constantevbObjectError. Por ejemplo, para generar el número de error 513, asigne vbObjectError + 513 a la propiedad Number.
source	Opcional. Expresión de cadena que da nombre al objeto o la aplicación que ha generado el error. Al establecer la propiedad Source para un objeto, use el formulario project.class. Si no se especifica el origen, se usa el id. de programación 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 puede asignar a un código de error en tiempo de ejecución de Visual Basic, la cadena que devolvería la función Error se usa como Descripción. Si no hay ningún error de Visual Basic que corresponda a Number, se usa el mensaje "Error definido por la aplicación o por el objeto".
helpfile	Opcional. La ruta de acceso completa al archivo de Ayuda en la que se puede encontrar ayuda sobre este error. Si no se especifica, Visual Basic usa el nombre de archivo, la ruta de acceso y la unidad completa del archivo de la Ayuda de Visual Basic. Consulte HelpFile.
helpcontext	Opcional. El id. de contexto que identifica un tema dentro del archivoayuda que ofrece ayuda para el error. Si se omite, se usa el id. de contexto del archivo de la Ayuda de Visual Basic para error correspondiente a la propiedad Number, si existe. Consulte HelpContext.

Comentarios

Todos los argumentos son opcionales excepto número. Si usa Raise sin especificar algunos argumentos, y la configuración de propiedad del objeto Err contiene valores que no se han borrado, dichos valores sirven como los valores para su error.

Raise se usa para generar errores en tiempo de ejecución y se puede usar en lugar de la instrucción Error .

Raise es útil para generar errores al escribir módulos de clase, porque el objeto Err ofrece información más enriquecida de lo que es posible si genera errores con la instrucción Error. Por ejemplo, con el método Raise, el origen que generó el error se puede especificar en la propiedad Source, se puede hacer referencia a la Ayuda en línea para el error, etc.

Ejemplo

Este ejemplo usa el método Raise del objeto Err para generar un error dentro de un objeto de automatización escrito en Visual Basic. Tiene el identificador MyProj.MyObjectde programación . En Macintosh, el nombre de unidad predeterminado es "HD" y las partes de la ruta de acceso se separan con comas, y no con barras diagonales inversas.

Const MyContextID = 1010407    ' Define a constant for contextID.
Function TestName(CurrentName, NewName)
    If Instr(NewName, "bob") Then    ' Test the validity of NewName.
        ' Raise the exception
        Err.Raise vbObjectError + 513, "MyProj.MyObject", _
        "No ""bob"" allowed in your name", "c:\MyProj\MyHelp.Hlp", _
        MyContextID
    End If
End Function

Vea también

• Objetos (Visual Basic para Aplicaciones)

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.