Erro de ajuste de registro com o Visual Basic for Applications

Quando um erro em tempo de execução ocorre em um Microsoft Visual Basic para aplicativos macro, uma mensagem de erro aparece na tela e a macro pára ou se comporta de forma imprevisível.

Para impedir que o aplicativo falhando ou se comportando de forma imprevisível, você pode incluir código de macro que intercepta o erro e informa a macro como manipulá-lo. O processo de interceptar e manipular um erro em tempo de execução é chamado de "interceptação de erro". O conjunto de instruções que informa o aplicativo como manipular o erro é chamado o "rotina de tratamento de erros" ou "identificador de erro".

Microsoft fornece exemplos de programação apenas para ilustração, sem garantia expressa ou implícita. Isso inclui, mas não está limitado a, garantias implícitas de comercialização ou adequação para uma finalidade específica. Este artigo presume que você está familiarizados com a linguagem de programação que está sendo demonstrada e com as ferramentas que são usadas para criar e depurar procedimentos. Engenheiros de suporte podem ajudar a explicar a funcionalidade de um determinado procedimento, mas eles não modificarão esses exemplos para fornecer funcionalidades adicionais ou construir procedimentos para atender às suas necessidades. Enquanto o código do Visual Basic estiver sendo executado, você pode encontrar vários tipos de erros que podem ser interceptados. Você pode tirar proveito de interceptação de erro no Microsoft Excel usando as seguintes funções e instruções.

Na política de erros

A declaração On Error faz com que Visual Basic for Applications iniciar ou Parar ajuste de registro de erro. A declaração On Error também especifica um conjunto de instruções para executar se um erro for encontrado.

Para obter informações adicionais, leia os seguintes artigos na Base de dados de Conhecimento da Microsoft:

Função de erro

A função Err retorna o número de erro encontrado.

Exemplo usando a função de erro: a tabela a seguir contém uma lista dos códigos de erro interceptável você pode encontrar ao usar a função Err. para obter informações adicionais, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:

Função de erro

A função erro retorna a mensagem de erro que corresponde a um número determinado erro.

Exemplo usando a função de erro:

Erro de declaração

A declaração Error Simula a ocorrência de um erro, permitindo que você atribuir um número erro personalizado para a função Err. Esses valores de erro definido pelo usuário-são valores que você definir para seus procedimentos e que sempre são armazenados em variáveis do tipo de dados Variant. Um uso comum desse tipo de valor de erro é nos procedimentos que aceitam vários argumentos e retornam um valor. Por exemplo, suponha que o valor de retorno é válido somente se os argumentos estejam dentro de um determinado intervalo. O procedimento pode testar os argumentos que o usuário fornece e se os argumentos não estiverem no intervalo aceitável, você pode ter o retorno do procedimento o valor de erro apropriado.

Erro é um subtipo do tipo de dados Variant e quando o termo "valor de erro" é usado, isso normalmente significa que uma variável é do tipo Variant e que ele contém um valor que o Visual Basic for Applications reconheça como um erro definido pelo usuário. Valores de erro são usados em um procedimento para indicar que as condições de erro tenham ocorrido. Ao contrário dos erros em tempo de execução normais, esses erros não interrompam o código porque eles são reconhecidos como variáveis comuns e não os erros. Os procedimentos podem testar esses valores de erro e tome as ações corretivas apropriadas.

Você também pode usar a instrução Error para simular erros em tempo de execução. Isso é especialmente útil quando você está testando seus aplicativos, ou quando você deseja tratar uma determinada condição como sendo equivalente a um erro em tempo de execução. Qualquer erro em tempo de execução aplicativos do Visual Basic pode ser simulado, fornecendo o código de erro para o erro em uma instrução de erro. Você também pode usar a instrução de erro para criar seus próprios erros definidos pelo usuário, fornecendo um código de erro que não corresponde a um Visual Basic para erro de tempo de execução de aplicativos. A tabela que contém uma lista de erros internas aparece anteriormente neste artigo (na seção "Função de erro"). Neste momento, o Visual Basic for Applications não usa todos os números disponíveis para erros internos. Em futuras versões do Visual Basic for Applications, números internos aumentará como mais interno - erros são adicionados. É recomendável que você inicia os números de erro em 50.000 e funciona de maneira até 65.535 para evitar possíveis conflitos no futuro.

Exemplo usando política de erros para Simulate erros de tempo de execução: macro quando o teste é executada, você receberá uma caixa de mensagem que contém "meu próprio erro" como a mensagem.

Função CVErr

A função CVErr é usada para criar valores de erro. CVErr função usa um argumento que deve ser um número inteiro ou ser uma variável que contém um número inteiro. exemplo usando a função CVErr:

Usando valores de erro internas

Há sete valores de erro internas no Microsoft Excel. A tabela abaixo mostra o número de erro (constante), o valor de erro literal e o valor de erro convertido. você trabalhar com esses valores de erro de planilha internas da mesma maneira que trabalha com erros definidos pelo usuário--como números convertida em valores de erro usando a função CVErr. A única diferença é que, para os erros de planilha, o Visual Basic for Applications fornece os números de erro como constantes internas e também fornece valores de erro literal. Esses itens não são fornecidos para valores de erro definido pelo usuário. Os valores de erro literal devem ser entre colchetes, como mostra a tabela acima.

Valores de exemplo com erro interna:

Centralizar o código de tratamento de erros

Quando você adiciona código de tratamento de erros do Visual Basic para aplicativos macros, você descobrirá que os erros mesmos estão sendo manipulados repetidas vezes. Você pode reduzir o tamanho do seu código e o esforço necessário para escrever código escrevendo alguns procedimentos que o seu código de tratamento de erros pode chamar para lidar com as situações de erro comuns.

O seguinte é um exemplo de um procedimento de função que exibe uma mensagem correspondente para o erro que ocorreu e sempre que possível, permite que o usuário especifique que ação tomar próxima escolhendo um determinado botão. Ele retorna o número código ao procedimento que chamou.

Interrompe o tratamento de usuário

Um usuário pode interromper um procedimento do Visual Basic for Applications pressionando CTRL+BREAK ou ESC (COMMAND + ponto no Macintosh). É possível desativar as interrupções para procedimentos em seus aplicativos concluídos. No entanto, se você não desativar as interrupções de usuário no procedimento concluído, você pode fazer-se de que o procedimento é notificado quando uma interrupção ocorreu para que possa fechar arquivos, desconectar-se de recursos compartilhados ou restaurar variáveis modificadas antes de retornar o controle do aplicativo para o usuário.

Você ajustar o pode registro interrupções do usuário nos seus procedimentos, definindo o EnableCancelKey de propriedade para xlErrorHandler. Quando essa propriedade é definida, todas as interrupções irão gerar um tempo de execução número do erro 18, que pode ser interceptado usando um erro na instrução. Você pode manipular o erro para interromper o procedimento e sair do programa. Se a instrução Resume é usada para continuar o procedimento após um erro de tempo de execução trapped, a interrupção será ignorada.

Também é possível ignorar completamente interrupções de usuário definindo a propriedade EnableCancelKey para xlDisabled. Nesse estado, o Microsoft Excel ignora todas as tentativas pelo usuário interromper o procedimento em execução. Para restaurar a interrupção de padrão de processamento, altere a configuração da propriedade EnableCancelKey para xlInterrupt. Para impedir que um procedimento desativar permanentemente interrupções do usuário, Microsoft Excel sempre restaura a configuração padrão da propriedade EnableCancelKey xlInterrupt sempre que o procedimento for concluído sua execução. Para garantir que as interrupções são manipuladas corretamente dentro do seu código, você deve explicitamente desative ou interceptar as interrupções de cada vez que o procedimento é executado. Deve-se observar esse manipulador de interrupção somente um pode ser usado para cada procedimento e que o mesmo manipulador é usado para todos os erros de tempo de execução encontrados por esse procedimento.

O exemplo a seguir demonstra um procedimento que requer um grande período de tempo para ser concluída. Se um usuário interrompe o procedimento, um erro será interceptado. A interrupção de usuário primeiro confirma que o procedimento, na verdade, deve ser interrompido e, em seguida, sai o procedimento de maneira ordenada. se você executa a macro ProcessData e, em seguida, pressione CTRL+BREAK rapidamente, será exibida uma caixa de mensagem que lhe peça se deseja parar o processamento de registros. Se você clicar em Sim, outra caixa de mensagem com "usuário interrupção ocorreu" será exibida. Se você clicar em OK nesta caixa de mensagem, a macro termina. Se você clicar em não na primeira caixa de mensagem, a macro continua.

Declaração de currículo

A instrução Resume continua a execução remota de código após um rotina de manipulação de erro.

Excel 97

Para obter mais informações sobre erros de macro do ajuste de registro, clique no índice de tabulação no Microsoft Excel 97 Ajuda do Visual Basic, digite o seguinte texto e, em seguida, clique duas vezes no texto selecionado para ir para o tópico "Erros interceptáveis".

Excel 7.0

Para obter mais informações sobre ajuste de registro erros de macro, clique no índice de tabulação no Microsoft Excel 7.0 Ajuda, digite o seguinte texto e, em seguida, clique duas vezes no texto selecionado para ir para o tópico "Ajuste de registro de erro".

Excel 5.0

No "Guia do usuário do Visual Basic", versão 5.0, capítulo 9, "Manipulando erros e erro valores", consulte os seguintes tópicos:

• "Impedir que seu código de interromper ou atuando de forma imprevisível"
• "Criando valores de erro que não o código de interrupção"
• "Usando os valores de erro interno do Microsoft Excel"
• "Técnicas de manipulação de erro avançadas"