Активизирует подпрограмму обработки ошибок и указывает положение подпрограммы в процедуре; используется также для отключения подпрограммы обработки ошибок.
On Error GoTo строка Активизирует подпрограмму обработки ошибок, начало которой определяется обязательным аргументом строка, значением которого может быть любая метка строки или номер строки. Если возвращается ошибка выполнения, управление передается на указанную строку и запускается обработчик ошибок. Аргумент строка должен определять строку в той же процедуре, в которой находится инструкция On Error; в противном случае возникает ошибка компиляции. On Error Resume Next Указывает, что возникновение ошибки выполнения приводит к передаче управления на инструкцию, непосредственно следующую за инструкцией, при выполнении которой возникла ошибка. Рекомендуется при доступе к объектам использовать эту форму инструкции, а не On Error GoTo. On Error GoTo 0 Отключает любой активизированный обработчик ошибок в текущей процедуре.
Замечания
Если не выполнена инструкция On Error, то любая ошибка
выполнения является фатальной; это означает, что выводится сообщение об ошибке и
выполнение программы прекращается.
"Включенным" обработчиком ошибок называют
подпрограмму, которая указана в инструкции On Error; "активным"
обработчиком ошибок является включенный обработчик ошибок, который обрабатывает
текущую ошибку. Если ошибка возникает в самом обработчике ошибок (в промежутке
между возникновением ошибки и выполнением инструкции Resume, Exit
Sub, Exit Function или Exit Property), то обработчик ошибок,
определенный в текущей процедуре, не может обработать ошибку. Управление в этом
случае возвращается в вызывающую процедуру; если в вызывающей процедуре включен
обработчик ошибок, то обработка ошибки передается ему. Если этот обработчик
ошибок является в данный момент активным, т.е. уже обрабатывает ошибку, то
управление снова передается назад в вызывающую процедуру и т.д. до тех пор, пока
не будет найден включенный, но не активный обработчик ошибок. Если включенный,
но неактивный обработчик ошибок найден не будет, ошибка становится фатальной в
том месте программы, в котором она впервые возникла. При каждой передаче
управления обработчиком ошибок в вызывающую процедуру эта процедура становится
текущей. После завершения обработки ошибки обработчиком в любой процедуре
возобновляется выполнение текущей процедуры с той ее части, которая указана в
инструкции Resume.
Подпрограмма обработки ошибок не может быть
процедурой Sub или Function. Эта подпрограмма должна быть частью
программы, которая отмечается с помощью метки строки или номера строки.
Для
определения причины ошибки в подпрограммах обработки ошибок используют значение
свойства Number объекта Err. Необходимо обеспечить в подпрограммах
обработки ошибок проверку или сохранение существенных значений свойств объекта
Err перед тем, как может возникнуть новая ошибка или перед вызовом
процедуры, в которой может возникнуть новая ошибка. Значения свойств объекта
Err описывают последнюю ошибку. Текст сообщения об ошибке,
соответствующего коду ошибки Err.Number содержится в свойстве
Err.Description.
Конструкция On Error Resume Next задает
продолжение выполнения с инструкции, непосредственно следующей за инструкцией,
которая привела к ошибке выполнения, или с инструкции, непосредственно следующей
за вызывающей инструкцией в процедуре, содержащей конструкцию On Error Resume
Next. Это позволяет продолжить исполнение программы несмотря на ошибку
выполнения. Это позволяет также встроить подпрограмму обработки ошибок в
процедуру, а не передавать управление в другую часть процедуры. Конструкция
On Error Resume Next становится неактивной при вызове новой процедуры,
поэтому для внутренней обработки ошибок необходимо выполнять инструкцию On
Error Resume Next в каждой вызываемой процедуре.
При обработке ошибок,
возникающих при доступе к другим объектам, рекомендуется использовать
конструкцию On Error Resume Next, а не конструкцию On Error GoTo.
Проверка объекта Err после каждого взаимодействия с другим объектом
позволяет устранить неопределенность в том, при доступе к какому объекту
возникла ошибка. Это позволяет всегда точно знать, какой объект поместил
значение кода ошибки в свойство Err.Number, а также в каком объекте
возникла ошибка (эта информация содержится в свойстве
Err.Source).
Конструкция On Error GoTo 0 отключает обработку
ошибок в текущей процедуре. Эта конструкция не задает переход на строку 0 для
обработки ошибок, даже если в процедуре имеется строка с номером 0. Если
инструкция On Error GoTo 0 не выполнялась, то обработчик автоматически
отключается при выходе из процедуры.
Для того чтобы предотвратить выполнение
программы обработки ошибок в тех случаях, когда ошибка не возникла, следует
помещать соответствующую инструкцию Exit Sub, Exit Function или
Exit Property сразу после подпрограммы обработки ошибки, как в следующем
примере:
Sub InitializeMatrix(Var1, Var2, Var3, Var4) On Error GoTo ОбработкаОшибок . . . Exit Sub ОбработкаОшибок: . . . Resume Next End Sub
В этом примере программа обработки ошибок помещена между инструкциями Exit Sub и End Sub, что позволяет отделить ее от части программы, соответствующей нормальному выполнению процедуры. Программу обработки ошибок можно разместить в любом месте процедуры.
Ошибки, которые не были перехвачены, возвращаются в управляющее приложение, если объект был запущен как исполняемый файл. В среде разработчика такие ошибки возвращаются в управляющее приложение только при указании соответствующих параметров. За описанием необходимых значений этих параметров и способов их задания следует обращаться к документации главного приложения. Там же следует проверить, позволяет ли главное приложение создавать классы.
Err.Number = vbObjectError + 1052
Системные ошибки при вызовах библиотек динамической компоновки (DLL) не приводят к возникновению исключений и не перехватываются средствами Visual Basic. При вызове функций из библиотек DLL необходимо проверять, успешно ли возвращается каждое значение (согласно спецификациям API), и в случае неудачи проверять значение свойства LastDLLError объекта Err.
Пример
В начале этой программы инструкция On Error GoTo определяет положение
подпрограммы обработки ошибок в процедуре. В данном примере попытка удалить
открытый файл приводит к возникновению ошибки с кодом 55. Ошибка обрабатывается
в подпрограмме, после чего управление возвращается инструкции, которая привела к
возникновению ошибки. Инструкция On Error GoTo 0 отключает перехват
ошибок. После этого инструкция On Error Resume Next задает отложенный
перехват ошибок, что позволяет точно определить, в каком контексте возникла
ошибка, генерируемая в следующей инструкции. Следует отметить, что после
обработки ошибки вызывается метод Err.Clear для сброса значений свойств
объекта Err.
Sub OnErrorStatementDemo() On Error GoTo ErrorHandler ' Включаем программу обработки ' ошибок. Open "TESTFILE" For Output As #1 ' Открываем файл. Kill "TESTFILE" ' Попытка удалить открытый ' файл. On Error Goto 0 ' Отключаем перехват ошибок. On Error Resume Next ' Откладываем перехват ошибок. ObjectRef = GetObject("MyWord.Basic") ' Запускаем несуществующий ' объект, а затем проверяем ' ошибку механизма управления ' программируемыми объектами. If Err.Number = 440 Or Err.Number = 432 Then ' Выводим сообщение для пользователя и очищаем объект Err. Msg = "Ошибка при попытке открыть программируемый объект!" MsgBox Msg, , "Проверка отложенной ошибки" Err.Clear ' Очищаем поля объекта Err. End If Exit Sub ' Выходим из процедуры, чтобы ' не попасть в обработчик. ErrorHandler: ' Обработчик ошибок. Select Case Err.Number ' Определяем код ошибки. Case 55 ' "Ошибка "Файл уже открыт". Close #1 ' Закрываем открытый файл. Case Else ' Здесь размещаются инструкции для обработки других ошибок... End Select Resume ' Возобновляем выполнение ' со строки, вызвавшей ошибку. End Sub