Поделиться через

Объект error (ADO)

  • Статья

Область применения: Access 2013, Office 2013

Содержит сведения об ошибках доступа к данным, относящихся к одной операции с участием поставщика.

Замечания

Любая операция с использованием объектов ADO может привести к возникновению одной или нескольких ошибок поставщика. При возникновении каждой ошибки один или несколько объектов Error помещаются в коллекцию Errors объекта Connection . Когда другая операция ADO создает ошибку, коллекция Errors очищается, а новый набор объектов Error помещается в коллекцию Errors .

Примечание.

Каждый объект Error представляет определенную ошибку поставщика, а не ошибку ADO. Ошибки ADO предоставляются механизму обработки исключений во время выполнения. Например, в Microsoft Visual Basic при возникновении конкретной ошибки ADO запускается событие On Error и отображается в объекте Error . Полный список ошибок ADO см. в разделе ErrorValueEnum .

Вы можете прочитать свойства объекта Error , чтобы получить конкретные сведения о каждой ошибке, включая следующие:

  • Свойство Description , содержащее текст ошибки. Это свойство по умолчанию.

  • Свойство Number , содержащее длинное целое число константы ошибки.

  • Свойство Source , которое идентифицирует объект, вызваввший ошибку. Это особенно полезно при наличии нескольких объектов Error в коллекции Errors после запроса к источнику данных.

  • Свойства SQLState и NativeError , которые предоставляют сведения из источников данных SQL.

При возникновении ошибки поставщика она помещается в коллекцию Errors объекта Connection . ADO поддерживает возврат нескольких ошибок одной операцией ADO, что позволяет получить сведения об ошибках, характерные для поставщика. Чтобы получить эти обширные сведения об ошибках в обработчике ошибок, используйте соответствующие функции перехвата ошибок языка или среды, с которыми вы работаете, а затем используйте вложенные циклы для перечисления свойств каждого объекта Error в коллекции Errors .

Пользователи Microsoft Visual Basic и VBScriptЕсли нет допустимого объекта Connection , необходимо получить сведения об ошибке из объекта Error .

Так же, как это делают поставщики, ADO очищает объект OLE Error Info перед выполнением вызова, который может потенциально создать новую ошибку поставщика. Однако коллекция Errors в объекте Connection очищается и заполняется только в том случае, если поставщик создает новую ошибку или когда вызывается метод Clear .

Некоторые свойства и методы возвращают предупреждения, которые отображаются как объекты Error в коллекции Errors , но не останавливают выполнение программы. Перед вызовом методов Resync, UpdateBatch или CancelBatch для объекта Recordset ; Метод Open в объекте Connection ; или задайте свойство Filter для объекта Recordset , вызовите метод Clear в коллекции Errors . Таким образом, можно прочитать свойство Count коллекции Errors , чтобы проверить наличие возвращенных предупреждений.