Erro de véu com o Visual Basic for Applications

Quando ocorre um erro no tempo de execução num Microsoft Visual Basic para aplicações de macro, uma mensagem de erro é apresentada no ecrã e a macro pára ou apresentar um comportamento imprevisível.

Para impedir que a aplicação de bloquear ou um comportamento modo imprevisível, pode incluir código de macro que intercepta o erro e explica como processar a macro. O processo de interceptar e processar um erro durante a execução é chamado de "intercepção de erros." O conjunto de instruções que indica a aplicação como lidar com o erro é chamado "rotina de tratamento de erro" ou "processador de erros."

A Microsoft fornece exemplos de programação apenas, para fins sem garantia expressa ou implícita. Isto inclui, mas não está limitado a, as garantias implícitas de comercialização ou adequação a um fim específico. Este artigo pressupõe que está familiarizado com a linguagem de programação apresentada e as ferramentas que são utilizadas para criar e depurar procedimentos. Os técnicos de suporte da Microsoft podem ajudar a explicar a funcionalidade de um determinado procedimento, mas não modificarão estes exemplos para proporcionarem funcionalidades adicionais nem criarão procedimentos adaptados às necessidades específicas do utilizador. Durante a execução do código do Visual Basic, poderá encontrar diversos tipos de erros que podem ser aplicados véus. Pode tirar partido de intercepção de erros no Microsoft Excel utilizando as seguintes funções e instruções.

Na declaração de erros

A instrução em erro faz com que Visual Basic for Applications iniciar ou parar intercepção de erros. A instrução de erro também especifica um conjunto de instruções para executar se for detectado um erro.

Para obter informações adicionais, consulte os seguintes artigos na base de dados de conhecimento da Microsoft:

Mensagem de função

A função Err devolve o número do erro encontrado.

Exemplo utilizando a função de erro: a tabela seguinte contém uma lista dos códigos de erro interceptável poderão ocorrer quando utilizar 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 de erro devolve a mensagem de erro que corresponde a um número determinado erro.

Exemplo utilizando a função de erro:

Declaração de erro

A instrução erro simula a ocorrência do erro, permitindo-lhe atribuir um número de erro personalizadas a função Err. Estes valores de erro definido pelo utilizador-são valores que pode definir para os procedimentos e que são sempre armazenadas em variáveis do tipo de dados variante. Uma utilização comum deste tipo de valor de erro é nos procedimentos que aceitam vários argumentos e devolvem um valor. Por exemplo, suponha que o valor devolvido é válido apenas se os argumentos incidem dentro de um determinado intervalo. O procedimento pode testar os argumentos que o utilizador forneça e se os argumentos não estiverem num intervalo aceitável, pode ter o retorno do procedimento o valor de erro adequada.

Erro é um subtipo do tipo de dados variante e quando é utilizado o termo "valor de erro", isto normalmente significa que é uma variável do tipo de variante e que contém um valor que o Visual Basic for Applications reconheça como um erro definido pelo utilizador. Valores de erro são utilizados num procedimento para indicar que ocorreram as condições de erro. Ao contrário dos erros durante a execução normais, estes erros não interrompem o código porque forem reconhecidos como variáveis normais e não os erros. Os procedimentos podem testar estes valores de erro e efectuar as acções correctivas adequadas.

Também pode utilizar a instrução de erro para simular erros de tempo de execução. Isto é especialmente útil quando estiver a testar as aplicações ou quando pretende tratar de uma determinada condição como sendo equivalente a um erro de tempo de execução. Qualquer Visual Basic for Applications run-time error pode ser simulado fornecendo o código de erro para o erro uma instrução de erro. Também pode utilizar a instrução de erro para criar os seus próprios erros definidos pelo utilizador, fornecendo um código de erro que não corresponde do Visual Basic for Applications run-time error. A tabela que contém uma lista de erros incorporados aparece neste artigo (na secção "Mensagem de função"). Neste momento, Visual Basic for Applications não utiliza todos os números disponíveis para erros internos. Em futuras versões do Visual Basic for Applications, os números internos aumentará como criado - erros são adicionados mais. Recomenda-se que inicie os números de erro no 50.000 e trabalhar da forma até 65.535 para evitar possíveis conflitos no futuro.

Exemplo utilizando o erro de declaração para Simulate Run-time erros: quando testar a macro é executada, será apresentada uma caixa de mensagem que contém "as minhas próprias erro" como a mensagem.

Função ' CVErr '

A função CVErr é utilizada para criar valores de erro. CVErr função tem um argumento que tem de ser um número inteiro ou ser uma variável que contém um número inteiro. exemplo utilizando a função ' CVErr:

Utilizar valores de erro incorporadas

Existem sete valores de erro incorporadas no Microsoft Excel. A tabela abaixo mostra o número de erro (constante), o valor de erro literal e o valor de erro convertidos. trabalha com estes valores de erro de folha de cálculo incorporadas da mesma forma que trabalha com os erros definidos pelo utilizador--como números convertida para valores de erro utilizando a função ' CVErr '. A única diferença é que para os erros de folha de cálculo, o Visual Basic for Applications fornece os números de erro como constantes incorporadas e também fornece valores de erro literal. Estes itens não são fornecidos para valores de erro definido pelo utilizador. Os valores de erro literal deverão estar entre parênteses rectos, conforme mostrado na tabela acima.

Valores de exemplo utilizando erro incorporado:

Centralizar o código de processamento de erros

Quando adiciona o código de tratamento de erros para o Visual Basic para as macros, irá descobrir que os erros mesmos estão a ser processados repetidamente. Pode reduzir o tamanho do código e o esforço necessário para escrever código escrevendo alguns procedimentos que pode chamar o código de tratamento de erros para lidar com situações de erro comuns.

Segue-se um exemplo de um procedimento função que apresenta uma mensagem correspondente ao erro que ocorreu e sempre que possível, permite ao utilizador especificar que acção a tomar seguinte escolhendo um determinado botão. Em seguida, devolve o número de código ao procedimento chamado-lo.

Processar utilizador interrupções

Um utilizador pode interromper um procedimento do Visual Basic for Applications, premindo CTRL+BREAK ou ESC (COMMAND + ponto no Macintosh). É possível desactivar as interrupções para os procedimentos nas suas aplicações terminar. No entanto, se não desactivar as interrupções de utilizador no procedimento terminar, pode certificar-se de que o procedimento é notificado de quando ocorreu uma interrupção para que possa fechar ficheiros, desligar recursos partilhados ou restaurar variáveis modificadas antes de devolver o controlo da aplicação para o utilizador.

Pode aplicar véus interrupções de utilizador em procedimentos de definindo o EnableCancelKey propriedade xlErrorHandler. Quando esta propriedade estiver definida, todas as interrupções irão gerar um tempo de execução erro número 18, aplicados pode ser véus utilizando um erro na instrução. Pode tratar o erro para parar o procedimento e sair do programa. Se for utilizada a instrução de continuar para continuar o procedimento depois de um erro de tempo de execução trapped, a interrupção é ignorada.

Também é possível ignorar interrupções de utilizador completamente definindo a propriedade EnableCancelKey para xlDisabled. Neste estado, o Microsoft Excel ignora todas as tentativas pelo utilizador para interromper o procedimento em execução. Para restaurar a interrupção de predefinição de processamento, altere a definição da propriedade EnableCancelKey para xlInterrupt. Impedir que um procedimento desactivar permanentemente as interrupções do utilizador, o Microsoft Excel sempre repõe a predefinição da propriedade EnableCancelKey xlInterrupt sempre que o procedimento conclui a respectiva execução. Para garantir que as interrupções são processadas correctamente no seu código, tem que explicitamente desactive ou as interrupções de trap sempre que o procedimento é executado. Saliente se esse processador apenas uma interrupção pode ser utilizado para cada procedimento e que é utilizado o mesmo processador para todos os erros de tempo de execução encontrados por esse procedimento.

O exemplo seguinte demonstra um procedimento que requer um grande período de tempo a concluir. Se um utilizador interrompe o procedimento, aplicados véus um erro. A interrupção de utilizador primeiro confirma que o procedimento, na realidade, deve ser interrompido e, em seguida, sai o procedimento de uma forma ordenada. se executar a macro ProcessData e, em seguida, prima CTRL+BREAK rapidamente, é apresentada uma caixa de mensagem pede-lhe se pretende parar o processamento de registos. Se clicar em ' Sim ', aparece outra caixa de mensagem "Ocorreu de interrupção de utilizador". Se clicar em OK nesta caixa de mensagem, a macro termina. Se clicar em não na primeira caixa de mensagem, a macro continua.

Declaração de currículo

A instrução continuar retoma a execução de código depois de concluir um rotina de tratamento de erro.

Excel 97

Para mais informações sobre erros de macro do véu, clique no índice de tabulação no Microsoft Excel 97 ajuda do Visual Basic, escreva o seguinte texto e faça duplo clique sobre o texto seleccionado para ir para o tópico "Erros detectável".

Excel 7.0

Para mais informações sobre erros de macro do véu, clique no índice de tabulação no Microsoft Excel 7.0 ajuda, escreva o seguinte texto e faça duplo clique sobre o texto seleccionado para ir para o tópico "Erro de trap".

Excel 5.0

"Manual de utilizador do Visual Basic," versão 5.0, capítulo 9, "Processamento de erros e erro valores," consulte os seguintes tópicos:

• "Impedir o código de parar ou agir de modo imprevisível"
• "Criar valores de erro que não o código de interrupção"
• "Utilizar os valores de erro incorporada do Microsoft Excel"
• "Processamento de erros avançadas Techniques"