Método Raise

Gera um erro em tempo de execução.

Sintaxe

objeto. Aumentarnúmero, fonte, descrição, arquivo de ajuda, 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. Inteiro longo que identifica a natureza do erro. Erros do Visual Basic (erros definidos pelo Visual Basic e definidos pelo usuário) estão no intervalo de 0 a 65535. O intervalo 0 a 512 é reservado para erros do sistema; o intervalo 513-65535 está disponível para erros definidos pelo usuário. Ao definir a propriedade Number como seu próprio código de erro em um módulo de classe, você adiciona o número do código de erro à constantevbObjectError. Por exemplo, para gerar o erro número 513, atribua vbObjectError + 513 à propriedade Number .
source	Opcional. Expressão de cadeia de caracteres nomeando o objeto ou aplicativo que gerou o erro. Ao definir a propriedade Source para um objeto, use o formulário project.class. Se a origem não for especificada, a ID programática do projeto atual do Visual Basic será usada.
description	Opcional. Expressão de cadeia de caracteres que descreve o erro. Se não for especificado, o valor em Número será examinado. Se ele puder ser mapeado para um código de erro em tempo de execução do Visual Basic, a cadeia de caracteres que seria retornada pela função Error será usada como Descrição. Se não houver nenhum erro do Visual Basic correspondente ao Número, a mensagem "Erro definido pelo aplicativo ou definido pelo objeto" será usada.
helpfile	Opcional. O caminho totalmente qualificado para o arquivo help no qual a ajuda sobre esse erro pode ser encontrada. Se não for especificado, o Visual Basic usará a unidade, o caminho e o nome do arquivo de arquivo totalmente qualificados do arquivo de Ajuda do Visual Basic. Consulte HelpFile.
Helpcontext	Opcional. A ID de contexto que identifica um tópico no arquivo de ajuda que fornece ajuda para o erro. Se omitida, a ID de contexto do arquivo do Visual Basic Help para o erro correspondente à propriedade Number será usada, se ela existir. Consulte HelpContext.

Comentários

Todos os argumentos são opcionais, exceto número. Se você usar o Raise sem especificar alguns argumentos e as configurações de propriedade do objeto Err conterem valores que não foram desmarcados, esses valores servirão como valores para o erro.

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

O aumento é útil para gerar erros ao escrever módulos de classe, pois o objeto Err fornece informações mais avançadas do que é possível se você gerar erros com a instrução Error . Por exemplo, com o método Raise , a origem que gerou o erro pode ser especificada na propriedade Source , ajuda online para o erro pode ser referenciada e assim por diante.

Exemplo

Este exemplo usa o método Raise do objeto Err para gerar um erro dentro de um objeto de Automação escrito no Visual Basic. Ele tem a ID MyProj.MyObjectprogramática . 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.