Intercepção de erros com o Visual Basic for Applications no Excel para Mac

Traduções de Artigos Traduções de Artigos
Artigo: 193247 - Ver produtos para os quais este artigo se aplica.
Expandir tudo | Reduzir tudo

Nesta página

Sumário

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."

Mais Informação

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 para Mac 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.

Mensagem de função

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

Exemplo utilizando a função Err :
   Msgbox "The most recent error number is " & Err & _
      ". Its message text is: " & Error(Err)
				
a tabela seguinte contém uma lista dos códigos de erro interceptável poderão ocorrer quando utilizar a função Err .
   Error code   Error message
   ----------   -------------
   3            Return without GoSub
   5            Invalid procedure call
   6            Overflow
   7            Out of memory
   9            Subscript out of range
   10           This array is fixed or temporarily locked
   11           Division by zero
   13           Type mismatch
   14           Out of string space
   16           Expression too complex
   17           Can't perform requested operation
   18           User interrupt occurred
   20           Resume without error
   28           Out of stack space
   35           Sub, function, or property not defined
   47           Too many DLL application clients
   48           Error in loading DLL
   49           Bad DLL calling convention
   51           Internal error
   52           Bad file name or number
   53           File not found
   54           Bad file mode
   55           File already open
   57           Device I/O error
   58           File already exists
   59           Bad record length
   61           Disk full
   62           Input past end of line
   63           Bad record number
   67           Too many files
   68           Device unavailable
   70           Permission denied
   71           Disk not ready
   74           Can't rename with different drive
   75           Path/File access error
   76           Path not found
   91           Object variable or With block variable not set
   92           For Loop not initialized
   93           Invalid pattern string
   94           Invalid use of Null
   298          System DLL could not be loaded
   320          Can't use character device names in specified file names
   321          Invalid file format
   322          Can't create necessary temporary file
   325          Invalid format in resource file
   327          Data value named was not found
   328          Illegal parameter; can't write arrays
   335          Could not access system registry
   336          ActiveX component not correctly registered
   337          ActiveX component not found
   338          ActiveX component did not correctly run
   360          Object already loaded
   361          Can't load or unload this object
   363          Specified ActiveX control not found
   364          Object was unloaded
   365          Unable to unload within this context
   368          The specified file is out of date. This program requires
                a newer version
   371          The specified object can't be used as an owner form for
                Show
   380          Invalid property value
   381          Invalid property-array index
   382          Property Set can't be executed at run time
   383          Property Set can't be used with a read-only property
   385          Need property-array index
   387          Property Set not permitted
   393          Property Get can't be executed at run time
   394          Property Get can't be executed on write-only property
   400          Form already displayed; can't show modally
   402          Code must close topmost modal form first
   419          Permission to use object denied
   422          Property not found
   423          Property or method not found
   424          Object required
   425          Invalid object use
   429          ActiveX component can't create object or return
                reference to this object
   430          Class doesn't support OLE Automation
   430          Class doesn't support Automation
   432          File name or class name not found during Automation
                operation
   438          Object doesn't support this property or method
   440          OLE Automation error
   440          Automation error
   442          Connection to type library or object library for remote
                process has been lost
   443          Automation object doesn't have a default value
   445          Object doesn't support this action
   446          Object doesn't support named arguments
   447          Object doesn't support current locale settings
   448          Named argument not found
   449          Argument not optional or invalid property assignment
   450          Wrong number of arguments or invalid property assignment
   451          Object not a collection
   452          Invalid ordinal
   453          Specified DLL function not found
   454          Code resource not found
   455          Code resource lock error
   457          This key is already associated with an element of this
                collection
   458          Variable uses a type not supported in Visual Basic
   459          This component doesn't support events
   460          Invalid Cipboard format
   461          Specified format doesn't match format of data
   480          Can't create AutoRedraw image
   481          Invalid picture
   482          Printer error
   483          Printer driver does not support specified property
   484          Problem getting printer information from the system.
                Make sure the printer is set up correctly
   485          Invalid picture type
   486          Can't print form image to this type of printer
   735          Can't save file to Temp directory
   744          Search text not found
   746          Replacements too long
   31001        Out of memory
   31004        No object
   31018        Class is not set
   31027        Unable to activate object
   31032        Unable to create embedded object
   31036        Error saving to file
   31037        Error loading from file
				

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 :
   Msgbox "The message text of the error is: " & Error(Err)
				

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.

Declaração de erros do exemplo utilizar Simulate Run-time erros:
   Sub Test()

      On Error Resume Next
      Error 50000          'set the value of Err to 50000

      If Err = 50000 Then
         MsgBox "my own error occurred"
      End If

   End Sub
				
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. A função CVErr tem um argumento que tem de ser um número inteiro ou ser uma variável que contém um número inteiro.
   NoRadius = CVErr(2010)

   NotANumber = 2020
   InvalidArgument = CVErr(NotANumber)
				
exemplo utilizando a função ' CVErr :
   Public NoRadius, NotANumber

   Sub AreaOfCircle()
      Const PI = 3.142
      NoRadius = CVErr(2010)
      NotANumber = CVErr(2020)
      Radius = CheckData(InputBox("Enter the radius: "))
      If IsError(Radius) Then
         Select Case Radius
            Case NoRadius
               MsgBox "Error: No radius given."
            Case NotANumber
               MsgBox "Error: Radius is not a number."
            Case Else
               MsgBox "Unknown Error."
         End Select
      Else
         MsgBox "The area of the circle is " & (PI * Radius ^ 2)
      End If
   End Sub

   Function CheckData(TheRadius)
      If Not IsNumeric(TheRadius) Then
         CheckData = NotANumber
      ElseIf TheRadius = 0 Then
         CheckData = NoRadius
      Else
         CheckData = TheRadius
      End If
   End Function
				

Utilizar valores de erro incorporadas

Existem sete valores de erro incorporadas no Excel para Mac. A tabela abaixo mostra o número de erro (constante), o valor de erro literal e o valor de erro convertidos.
Error number (Constant)   Literal error value     Converted error value

xlErrDiv0                   [#DIV/0!]               CVErr(xlErrDiv0)
xlErrNA                     [#N/A]                  CVErr(xlErrNA)
xlErrName                   [#NAME?]                CVErr(xlErrName)
xlErrNull                   [#NULL!]                CVErr(xlErrNull)
xlErrNum                    [#NUM!]                 CVErr(xlErrNum)
xlErrRef                    [#REF!]                 CVErr(xlErrRef)
xlErrValue                  [#VALUE!]
CVErr(xlErrValue)
				
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.

Exemplo utilizando valores de erro incorporadas:
   Function Commission(SharesSold,PricePerShare)
      If Not (IsNumeric(SharesSold) And IsNumeric(PricePerShare)) Then
         Commission = CVErr(xlErrNum)
      Else
         TotalSalePrice = ShareSold * PricePerShare
         If TotalSalePrice <= 15000 Then
            Commission = 25 + 0.03 * SharesSold
         Else
            Commission = 25 + 0.03 * (0.9 * SharesSold)
         End If
      End If
   End Function
				

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.
   Public Const RESUME_STATEMENT = 0   'Resume
   Public Const RESUME_NEXT = 1        'Resume Next
   Public Const UNRECOVERABLE = 2      'Unrecoverable error
   Public Const UNRECOGNIZED = 3       'Unrecognized error
   Public Const ERR_DEVICEUNAVAILABLE = 68
   Public Const ERR_BADFILENAMEORNUMBER = 52
   Public Const ERR_PATHDOESNOTEXIST = 76
   Public Const ERR_BADFILEMODE = 54

   Function FileErrors(errVal As Integer) As Integer
   Dim MsgType As Integer, Msg As String, Response As Integer
      MsgType = vbExalamation
      Select Case errVal
         Case ERR_DEVICEUNAVAILABLE     'Error #68
            Msg = "That device is unavailable."
            MsgType = MsgType + vbAbortRetryIgnore
         Case BADFILENAMEORNUMBER      'Errors #64 & 52
            Msg = "That filename is not valid."
            MsgType = MsgType + vbOKCancel
         Case PATHDOESNOTEXIST      'Error #76
            Msg = "That path does not exist."
            MsgType = MsgType + vbOKCancel
         Case BADFILEMODE      'Error #54
            Msg = "Can not open the file for that type of access."
            MsgType = MsgType + vbOKCancel
         Case Else
            FileErrors = UNRECOGNIZED
            Exit Function
      End Select
      Response = MsgBox(Msg, MsgType, "Disk Error")
      Select Case Response
         Case vbOK, vbRetry
            FileErrors = RESUME_STATEMENT
         Case vbIgnore
            FileErrors = RESUME_NEXT
         Case vbCancel, vbAbort
            FileErrors = UNRECOVERABLE
         Case Else
            FileErrors = UNRECOGNIZED
      End Select
   End Function
				

Processar utilizador interrupções

Um utilizador pode interromper um procedimento do Visual Basic for Applications premindo COMMAND + ponto. É 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 a propriedade EnableCancelKey para 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 uma instrução de Erro . 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 Excel para Mac 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, Excel para Mac 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.
   Sub ProcessData()
      'Set up a user interrupt trapping as a run-time error
      On Error GoTo UserInterrupt
      Application.EnableCancelKey = xlErrorHandler

      'Start a long duration task
      For x = 1 to 1000000
         For y = 1 to 10
         Next y
      Next x

      Exit Sub
   UserInterrupt:
      If Err = 18 Then
         If MsgBox ("Stop processing records?", vbYesNo) = vbNo Then
            'Continue running at the point procedure was interrupted
            Resume
         Else
            'Handle other errors that occur
            MsgBox Error(Err)
         End If
      End If
   End Sub
				
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.

Propriedades

Artigo: 193247 - Última revisão: 23 de janeiro de 2007 - Revisão: 5.4
A informação contida neste artigo aplica-se a:
  • Microsoft Excel 2004 for Mac
  • Microsoft Excel X para Macintosh
  • Microsoft Excel 2001 para Macintosh
  • Microsoft Excel 98 para Macintosh
Palavras-chave: 
kbmt kbdtacode kbhowto KB193247 KbMtpt
Tradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine translation ou MT), não tendo sido portanto revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 193247

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com