Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Содержит сведения об ошибках доступа к данным, относящихся к одной операции с участием поставщика.
Замечания
Любая операция, связанная с объектами ADO, может создавать одну или несколько ошибок поставщика. При возникновении каждой ошибки один или несколько объектов Error помещаются в коллекцию Errors объекта Connection. Когда другая операция ADO создает ошибку, коллекция ошибок очищается, а новый набор объектов Error помещается в коллекцию ошибок .
Замечание
Каждый объект Error представляет определенную ошибку поставщика, а не ошибку ADO. Ошибки ADO предоставляются механизму обработки исключений во время выполнения. Например, в Microsoft Visual Basic вхождение ошибки, относяющейся к ADO, активирует событие On Error и появится в объекте Error . Полный список ошибок ADO см. в разделе ErrorValueEnum .
Свойства объекта Error можно прочитать для получения конкретных сведений о каждой ошибке, включая следующие:
Свойство Description , содержащее текст ошибки. Это свойство по умолчанию.
Свойство Number , содержащее целочисленное значение длинного целого числа константы ошибки.
Свойство Source , определяющее объект, который вызвал ошибку. Это особенно полезно при наличии нескольких объектов Error в коллекции ошибок после запроса к источнику данных.
Свойства SQLState и NativeError , предоставляющие сведения из источников данных SQL.
При возникновении ошибки поставщика он помещается в коллекцию "Ошибки " объекта Connection . ADO поддерживает возврат нескольких ошибок одной операцией ADO, чтобы разрешить сведения об ошибках, относящиеся к поставщику. Чтобы получить подробные сведения об ошибках в обработчике ошибок, используйте соответствующие функции перехвата ошибок языка или среды, с которыми вы работаете, а затем используйте вложенные циклы для перечисления свойств каждого объекта Error в коллекции ошибок .
Замечание
Пользователи Microsoft Visual Basic и VBScript Если нет допустимого объекта Connection , необходимо получить сведения об ошибке из объекта Error .
Как и поставщики, ADO очищает объект OLE Error Info перед вызовом, который потенциально может создать ошибку поставщика. Однако коллекция ошибок объекта Connection очищается и заполняется только в том случае, если поставщик создает новую ошибку или вызывается метод Clear .
Некоторые свойства и методы возвращают предупреждения, которые отображаются как объекты error в коллекции Errors, но не остановить выполнение программы. Перед вызовом resync, UpdateBatchили методы CancelBatch в объекте Recordset; метод open в объекте connection; или задайте свойство Filter в объекте набора записей, вызовите метод Clear в коллекции Errors. Таким образом, можно прочитать свойство Count коллекции ошибок для проверки возвращаемых предупреждений.
Объект Error не является безопасным для скриптов.
Этот раздел содержит следующую тему.
См. также
описание, HelpContext, HelpFile, NativeError, Number, Source и SQLState Properties Example (VB)
описание, HelpContext, HelpFile, NativeError, Number, Source и SQLState Properties Example (VC++)
объект подключения (ADO)
коллекции ошибок (ADO)
Приложение A: Поставщики