Método de elevação

Gera um erro em tempo de execução.

Sintaxe

objeto de teste. 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 usuário e definidos pelo visual) estão no intervalo de 0 a 65535. O intervalo de 0 a 512 é reservado para erros do sistema; O intervalo de 513 a 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 seu número de código de erro à constantevbObjectError. Por exemplo, para gerar o número de erro 513, atribua vbObjectError + 513 à propriedade Number .
source Opcional. Expressão de cadeia de caracteres que nomeia 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 descrevendo 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 de tempo de execução do Visual Basic, a cadeia de caracteres que seria retornada pela função Error será usada como Description. Se não houver nenhum erro do Visual Basic correspondente a Number, será usada a mensagem "Erro definido pelo aplicativo ou definido pelo objeto".
helpfile Opcional. O caminho totalmente qualificado para o arquivo de Ajuda 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 de arquivo totalmente qualificados do arquivo de Ajuda do Visual Basic. Consulte o Arquivo de Ajuda.
Contexto de ajuda Opcional. A ID de contexto identificando um tópico no arquivo de ajuda que fornece ajuda para o erro. Se omitido, a ID de contexto do arquivo de Ajuda do Visual Basic para o erro correspondente à propriedade Number será usada, se ela existir. Consulte HelpContext.

Comentários

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

Raise é usado para gerar erros em tempo de execução e pode ser usado em vez da instrução Error .

Raise é ú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 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 , a 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 Automation escrito em Visual Basic. 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

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.

  • Last updated on