Método Raise

Gera um erro de tempo de execução.

Sintaxe

objeto. Aumentarnúmero, origem, descrição, helpfile, helpcontext

O método Raise tem o seguinte qualificador de objeto e argumentos nomeados:

Argumento	Descrição
objeto	Obrigatório. Sempre o objeto Err .
número	Obrigatório. Número inteiro longo que identifica a natureza do erro. Os erros do Visual Basic (erros definidos pelo Visual Basic e definidos pelo utilizador) estão no intervalo 0–65535. O intervalo 0-512 está reservado para erros de sistema; o intervalo 513–65535 está disponível para erros definidos pelo utilizador. Ao definir a propriedade Número para o seu próprio código de erro num módulo de classe, adicione o número do código de erro à constantevbObjectError. Por exemplo, para gerar o número de erro 513, atribua vbObjectError + 513 à propriedade Número .
source	Opcional. Expressão de cadeia que atribui o nome ao objeto ou à aplicação que gerou o erro. Ao definir a propriedade Origem para um objeto, utilize o formulário project.class. Se a origem não for especificada, é utilizado o ID programático do projeto Visual Basic atual.
description	Opcional. Expressão de cadeia que descreve o erro. Se não for especificado, o valor em Número é examinado. Se puder ser mapeado para um código de erro de tempo de execução do Visual Basic, a cadeia que seria devolvida pela função Error é utilizada como Descrição. Se não existir nenhum erro do Visual Basic correspondente a Número, é utilizada a mensagem "Erro definido pela aplicação ou definido pelo objeto".
helpfile	Opcional. O caminho completamente qualificado para o ficheiro de Ajuda no qual pode ser encontrada ajuda para este erro. Se não for especificado, o Visual Basic utiliza a unidade, o caminho e o nome de ficheiro completamente qualificados do ficheiro de Ajuda do Visual Basic. Consulte HelpFile.
helpcontext	Opcional. O ID de contexto que identifica um tópico no helpfile que fornece ajuda para o erro. Se for omitido, será utilizado o ID de contexto do ficheiro da Ajuda do Visual Basic para o erro correspondente à propriedade Número , se existir. Veja HelpContext.

Comentários

Todos os argumentos são opcionais , exceto o número. Se utilizar Aumentar sem especificar alguns argumentos e as definições de propriedade do objeto Err contiverem valores que não foram limpos, esses valores servem como valores para o seu erro.

O aumento é utilizado para gerar erros de tempo de execução e pode ser utilizado em vez da instrução Erro .

O aumento é útil para gerar erros ao escrever módulos de classe, porque o objeto Err fornece informações mais avançadas do que é possível se gerar erros com a instrução Erro . Por exemplo, com o método Raise , a origem que gerou o erro pode ser especificada na propriedade Origem , a Ajuda online para o erro pode ser referenciada, etc.

Exemplo

Este exemplo utiliza o método Raise do objeto Err para gerar um erro dentro de um objeto de Automatização escrito no Visual Basic. Tem o ID MyProj.MyObjectprogramático . No Macintosh, o nome da unidade padrão é "HD" e partes do nome do caminho são separadas por dois pontos em vez de barras invertidas.

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

Confira também

• Objetos (Visual Basic for Applications)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.