Объект Error
Содержит сведения об ошибках доступа к данным, относящихся к одной операции с участием поставщика.
Комментарии
Любая операция с объектами ADO может привести к возникновению одной или нескольких ошибок поставщика. При возникновении каждой ошибки один или несколько объектов Error помещаются в коллекцию Errors объекта Connection . Когда другая операция ADO создает ошибку, коллекция Errors очищается, а новый набор объектов Error помещается в коллекцию Errors .
Примечание
Каждый объект Error представляет определенную ошибку поставщика, а не ошибку ADO. Ошибки ADO предоставляются механизму обработки исключений во время выполнения. Например, в Microsoft Visual Basic возникновение ошибки, относяющейся к ADO, активирует событие On Error и появится в объекте Error . Полный список ошибок ADO см. в разделе ErrorValueEnum .
Вы можете прочитать свойства объекта Error , чтобы получить конкретные сведения о каждой ошибке, включая следующие:
Свойство Description , содержащее текст ошибки. Это свойство по умолчанию.
Свойство Number , содержащее целочисленное значение long константы ошибки.
Свойство 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 , чтобы проверить наличие возвращенных предупреждений.
Объект Error не безопасен для создания скриптов.
Этот раздел содержит следующий раздел.
См. также:
Description, HelpContext, HelpFile, NativeError, Number, Source и SQLState Properties Example (VB)
Description, HelpContext, HelpFile, NativeError, Number, Source и SQLState Properties Example (VC++)
Объект Connection (ADO)
Коллекция Errors (ADO)
Приложение А. Поставщики