Mostrar tudo

Ocultar tudo

Devolve uma Variante (tipo de dados Variante: tipo de dados predefinido para variáveis que não possuem caracteres de declaração de tipo quando uma instrução do tipo Def não está em vigor. Uma Variante pode armazenar dados numéricos, de cadeia, de data/hora, Nulo ou Vazio.) de subtipo Erro, que contém um número de erro (número de erro: número completo no intervalo 0 - 65.535 que corresponde à definição de propriedade Number do objecto Err. Quando combinado com a definição de propriedade Description do objecto Err, este número representa uma mensagem de erro específica.)especificado pelo utilizador.

Sintaxe

CVErr(númerodeerro)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) númerodeerroobrigatório é um número de erro inválido.

Observações

Utilize a função CVErr para criar erros definidos pelo utilizador em procedimentos (procedimento: sequência de declarações e instruções num módulo que são executadas como uma unidade. No Visual Basic, os procedimentos incluem os procedimentos Sub e Function.) criados pelo utilizador. Por exemplo, se criar uma função que aceita vários argumentos e que, normalmente, devolve uma cadeia, a avaliação pode avaliar os argumentos introduzidos para garantir que estes estão compreendidos num intervalo aceitável. Se não estiverem, é provável que a função não devolva o esperado. Nesse caso, a função CVErr permite-lhe devolver um número de erro que lhe indica a acção a executar.

Note que não é permitida a conversão implícita de um Erro. Por exemplo, não é possível atribuir directamente o valor devolvido de CVErr a uma variável (variável: um local de armazenamento com nome que pode conter dados que é possível modificar durante a execução do programa. Cada variável possui um nome que a identifica exclusivamente no respectivo nível de âmbito. Um tipo de dados pode ser ou não especificado.)que não seja uma Variante. No entanto, pode efectuar uma conversão explícita (utilizando CInt, CDup, etc.) do valor devolvido por CVErr e atribuí-lo a uma variável do tipo de dados (tipo de dados: característica de um campo que determina qual o tipo de dados que o mesmo pode conter. Os tipos de dados incluem o tipo de dados booleano, número inteiro, longo, moeda, simples, duplo, data, cadeia e variante (predefinição).) apropriado.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função CVErr para devolver uma Variante em que o VarType é vbError (10). A função definida pelo utilizador CalculateDouble devolve um erro se o argumento nela introduzido não for um número. Pode utilizar a função CVErr para devolver erros definidos pelo utilizador de procedimentos definidos pelo utilizador ou para adiar o tratamento de um erro de tempo de execução. Utilize a função IsError para testar se o valor representa um erro.

' Call CalculateDouble with an error-producing argument.
Sub Test()
    Debug.Print CalculateDouble("345.45robert")
End Sub
' Define CalculateDouble Function procedure.
Function CalculateDouble(Number)
    If IsNumeric(Number) Then
        CalculateDouble = Number * 2    ' Return result.
    Else
        CalculateDouble = CVErr(2001)    ' Return a user-defined error 
    End If    ' number.
End Function