Объекты1. Объект Connection - соединение позволяет приложениям установить связь с источником данных. После этого объектConnection можно употреблять для исполнения SQL-запросов, он может также использоваться объектами Command иRecordset. Для установления соединения с источником данных используется метод Open, для закрытия соединения - методClose. Свойства объекта Connection: o ConnectionTimeout. Указывает время ожидания выполнения операции установки связи с базой данных в секундах. По истечению заданного интервала генерируется ошибка, o ConnectionString. Предоставляет информацию, необходимую для установки связи с базой данных, o CursorLocation. Указывает позицию курсора, o DefaultDatabase. Указывает базу данных, заданную для данного объекта Connection по умолчанию, o Mode. Определяет права доступа на запись и чтение данных. Присвоить значение этому свойству можно только до установки связи с источником данных. В случае с удаленными службами данных его значение должно быть adModeUnknown, o State. Возвращает текущее состояние связи - значение adStateClosed, adStateOpen, adStateExecuting, adStateConnecting. Методы объекта Connection: o BeginTrans. Используется, чтобы начать транзакцию, o Cancel. Прекращает выполнение текущей асинхронной операции, o CommitTrans. Фиксирует все изменения в объекте Connection, o Execute. Выполняет команду, представленную в виде объекта Command. Формат обращения к этому объекту имеет вид: Connection.Еxecute CommandText, RecordsAffected, Options здесь: CommandText - это выражение SQL, имя таблицы, имя хранимой процедуры или иной текст команды. RecordsAffected возвращает количество записей, обработанных командой. В качестве значения параметра Options используют константу adExecuteSync, чтобы стартовать асинхронную операцию, или adFetchAsync, указывающее, что строки, остающиеся после заполнения буфера, должны возвращаться асинхронно, o Open. Устанавливает связь с источником данных. При использовании удаленных служб данных связь не устанавливается, пока не открыт набор записей Recordset. Формат обращения к методу Open: Сonnection.Open ConnectionString, UserID, Password, Option Аргументы UserID и Password задают соответственно учетную запись и пароль пользователя. Значение аргумента Option может быть установлено равным константе adAsyncConnect, чтобы установка связи происходила асинхронно. Все аргументы являются необязательными , o OpenSchema. Возвращает информацию о схеме базы данных, например, о структуре таблицы, o RollbackTrans. Отменяет все изменения в текущем объекте Connection, 2. Объект Command. Объект Command используется для передачи команд в источник данных. Для источников данных типа SQL Server состоят из динамических команд SQL, подготовленных команд SQL или вызовов хранимых процедур (Хранимая процедура предствляет собой откомпилированное заранее семейство инструкций SQL и необязательных инструкций управления порядком выполнения, хранимое под некоторым именем и обрабатываемое как единое целое). Свойство Текст команды (CommandText) содержит саму команду, а метод Исполнить (Execute) ее стартует. Некоторые свойства: o ActiveConnection. Ассоциирует объект Command с объектом Connection, o CommandText. Является текстовой строкой, содержащей команду, которая должна быть выполнена, например, инструкция языка SQL SELECT: acmd.CommandText = "SELECT * FROM empl" o CommandTimeout. Указывает период времени в секундах, предоставленный команде на выполнение. Если значение данного поля равно 0, то время ожидания не ограничено. Значение по умолчанию - 30, o CommandType. Описывает тип команды, o Prepared. Является значением типа Boolean, указывающим, нужно ли перед выполнением команды ее скомпилировать, o State. Указывает текущее состояние объекта. Методы объекта Command. У объекта Command есть три метода. Метод Execute используется для старта команд. Если команда возвращает строки таблицы, ее результат должен быть присвоен объекту Recordset: Set ars = acmd.Execute ars - объект типа Recordset, acmd - объект типа Command Метод Cancel используется для остановки выполнения текущей команды. Метод CreateParametеr используется для создания нового объектаParameter: Set Parameter = command.CreateParameter (Name, Type, Direction, Size, Value) 3. Коллекция. Parameters и объект Parameter Коллекция Parameters представляет все параметры или аргументы запроса или сохраненной процедуры. У каждого объекта Parameter есть коллекция Parameters. Свойства объекта Parameter: o Attributes. Описывает объект Parameter при помощи одной из следующих констант: adParamSigned - параметр принимает числовые значения со знаком, adParamNullable - параметр может принимать значение Null, adParamLong - объект может принимать значение двоичных или символьных данных очень большого размера через методAppendChunk, o Direction. Указывает направленность параметра, то есть определяет, является объект Parameter входным или выходным, или изменяемым параметром, или результатом выполнения хранимой процедуры базы данных, o NumericScale. Является переменной типа Byte, указывающей количество десятичных знаков для представления значения числового параметра, o Size. Указывает максимальный размер параметра в байтах, o Type. Указывает тип объекта Parameter, o Value. Задает и возвращает значение объекта Parameter. Тип этого свойства - Variant. Методы объекта Parameter: имеется один метод AppendChunk. Используемый формат: object.AppendChunk Data, здесь Data - данные, добавляемые к значению свойства Value объекта Parameter. При первом вызове этого метода данные не добавляются, они переписываются вместо старых данных. При последующих вызовах данные добавляются к концу существующих. Этот метод используется для размещения в объекте Parameter большого количества текстовой или двоичной информации. 4. Объект Recordset. Представляет набор записей той или иной базы данных либо набор записей, являющийся результатом выполнения определенной команды. Объект Recordset позволяет преходить от одной записи к другой, редактировать и удалять записи. В модели ADO для объектов Recordset применяются четыре различные типа курсора: o динамический курсор. Позволяет произвольно перемещаться по записям объекта, o индексный курсор. Аналогичен динамическому, но запрещает доступ к записям, добавленным или удаленным другими пользователями, o статический курсор. Создает Объект Recordset, который допускает неограниченное перемещение по объекту, однако изменения, вставки и удаления записей, произведенные другими пользователями невидимы, o однонаправленный курсор. Идентичен статическому курсору с той разницей, что по записям объекта можно двигаться только вперед. Свойства объекта Recordset: o AbsolutePosition. Возвращает или устанавливает абсолютный номер текущей записи. (Число типа Long, нумерация записей ведется с 1). Может также возвращать одну из следующих констант: o AdPosBOF указывает, что достигнуто начало файла, o AdPosEOF указывает, что достигнут конец файла, o adPosUnknown указывает, что позиция текущей записи неизвестна, o BOF. Будучи установленным True, указывает, что курсор указывает на начальную запись набора Recordset, o Bookmark. Устанавливает или возвращает значение типа Variant, содержащее определенную позицию (положение текущей записи) в базе данных. С помощью закладки можно запомнить текущую позицию и впоследствии вернуться к ней, o CacheSize. Устанавливает или возвращает количество локально буферируемых записей. Например, если установить значение этого свойства равным 20, то при открытии объекта Recordset в локальную память будет скопировано 20 записей. Чтобы в уже находящихся в буфере записях отобразились изменения, произведенные другими пользователями, нужно использовать метод Resync, o CursorLocation. Устанавливает или возвращает размещение механизма курсора. Значение adUseServer указывает, что должен использоваться курсор, базирующийся на сервере. Значение adUseClient указывает, что курсор должен управляться локально, o CursorType. Устанавливает или возвращает тип курсора. Может принимать значения: adOpenForwardOnly(однонаправленный), adOpenKeyset (индексный), adOpenDynamic (динамический), adOpenStatic (статический), o EditMode. Возвращает режим обработки текущей записи, o EOF. Если значение - True, то курсор находится в конце набора записей Recordset, o Filter. Устанавливает или возвращает значение типа Variant, которое может содержать текстовую строку критерия отбора записей (например, "emp_Gender = "ж" OR emp_Salary > 8000"), массив закладок или одну из констант. Для отмены действия условия отбора нужно присвоить этому свойству значение пустой строки "" или константуadFilterNone, o LockType. Устанавливает или возвращает тип блокировки, присущий данной записи, o MaxRecords. Ограничивает количество записей, предоставляемых по одному запросу, o PageSize. Позволяет разбить набор записей на логические страницы. Например, если вы хотите, чтобы на экране одновременно отображалось 20 записей, можно установить значение этого параметра равным 20. Можно пользоваться свойством AbsolutePage, для перехода на указанную страницу: o ' задать 20 страниц и перейти на 3-юo ars.PageSize = 20 ars.AbsolutePage = 3o PageCount возвращает количество страниц в базе данных, o RecordCount. Возвращает количество записей в базе данных, o Sort. Позволяет сортировать объект Recordset по любому полю или набору полей. Сортировка доступна, если значение свойства CursorLocation равно adUseClient. С помощью ключевого слова ASCENDING или DESCENDING может быть указан порядок сортировки. Например: ars.sort = "emp_gender", Ascending o Source. Устанавливает и возвращает источник данных, o State. Возвращает информацию о текущем состоянии объекта, o Status. Возвращает сведения о текущей записи в виде комбинации констант табл. 4.8
o Методы объекта Recordset: AddNew. Добавляет новую запись. Дополнительно можно указать значения полей записи. При этом имена полей и их значений указываются с помощью функции Array: ars.AddNew Array ("emp_salary", "emp_gender"), Array (55000, "m") o CancelBatch. Отменяет незавершенное пакетное обновление, o CancelUpdate. Отменяет незавершенные изменения, o Clone. Создает копию объекта Recordset со всеми сохраненными закладками, o Delete. Удаляет текущую запись, o Find - поиск. Синтаксис обращения: Find (criteria, SkipRows, searchDirection, start), здесь: criteria - допустимое выражение инструкции WHERE SQL (без самого ключевого слова WHERE), например, "emp_gender = 'g"" Ключевое слово Like может применяться для поиска похожих текстовых строк, например: ars.find ("emp_name Like 'F_*"). Аргумент SkipRows указывает количество строк таблицы, которые необходимо пропустить, начиная с заданной позиции. Аргумент SearchDirection указывает направление поиска. С помощью аргумента start можно передать закладку, с которой нужно начинать поиск, o Move. Позволяет переместить текущую позицию курсора, o MoveFirst, MoveLast, MoveNext, MovePrevious. Методы позволяют установить текущую позицию на первую, последнюю, следующую и предыдущую соответственно, o Requiry. Обновляет данные в объекте Recordset, выполняя запрос повторно, o Resync. Обновляет данные в объекте Recordset, отображая изменения, произведенные другими пользователями, o Save. Сохраняет объект Recordset в виде файла. Если установлено какое-либо условие отбора, то сохраняются только записи, удовлетворяющие ему. Файл не закрывается до тех пор, пока не будет закрыт объект Recordset. Синтаксис: Recordset.Save FileName, PersistFormat, здесь PersistFormat указывает формат файла. o Supports. Указывает, обладает ли объект Recordset определенными функциональными возможностями, o Update. Сохраняет изменения текущей записи. При перемещении от одной записи к другой программное обеспечение ADO автоматически вызывает метод Update, o UpdateBatch. Сохраняет все пакетные изменения на диске. 5. Коллекция Fields и объект Field. У каждого объекта Recordset есть коллекция Fields, состоящая из объектовField. Каждый объект Field представляет отдельное поле объекта Recordset. Объект Field содержит основную информацию о поле (значение, тип данных и размер). Каждый объект Field содержит коллекцию Properties. o Свойства объекта Field: ActualSize. Возвращает количество байт, хранящихся в поле, o Attributes. Описывает характеристики объекта. Используются некоторые константы, значение которых может принимать, o adFldUpdatable. Объект Field может быть обновлен, o adFldFixed. Объект Field содержит данные фиксированной длины, o adFldNullable. Объект Field может содержать значение Null, o adFldRowVersion. Объект Field содержит номер версии или отметку времени, o DefinedSize. Содержит максимальный размер объекта Field (в байтах), o Name. Содержит имя поля в базе данных или в команде выборки данных, o OriginalValue. Содержит значение объекта Field, присущее ему до измеения соответствующего поля, o Type. Возвращает константу, указывающую тип поля, o UnderLyingValue. Возвращает текущее значение поля, хранящееся в базе данных, o Value. Устанавливает или возвращает текущее значение поля. Методы объекта Field: у объекта Field есть два метода: AppendChunk и GetChunk, используемых для управления большими объемами двоичной или текстовой информации. Метод GetChunk используется для получения всей информации, хранящейся в объекте Field или ее части. С помощью метода AppendChunk можно добавить к полю новые данные. 6. Коллекция Properties и объект Propertу. У объектов Connection, Command, Recordset, Parameter и Field есть коллекция Properties, содержащая объекты Property. У объекта Property есть 4 свойства: o Name. Устанавливает или возвращает имя свойства, o Value. Устанавливает или возвращает значение свойства, o Attributes. Устанавливает или возвращает значение, равное комбинации констант: adPropNotSupported (поставщик не поддерживает это свойство), adPropRequired (значение этого свойства должно быть указано до инициализации источника данных), adPropOptional (значение этого свойства не обязательно указывать до инициализации источника данных), adPropRead (свойство доступно для чтения), adPropWrite (свойство доступно для записи), o Type. Устанавливает или возвращает тип данных. 7. Коллекция Errors и объект Error. При возникновении ошибки поставщика данных, содержимое коллекции удаляется и в коллекцию помещается один или несколько новых объектов Error. Некоторые сообщения поставщика данных добавляются к коллекции Errors, не приостанавливая выполнения программы. При каждом действии, которое может вызвать ошибку, следует очищать коллекцию с помощью метода Clear. Ошибки ADO обрабатываются системой обработки Visual Basic. Свойства объекта Error: o Description. Возвращает строку с кратким описанием ошибки. Задается либо программным обеспечением ADO, либо поставщиком данных, o NativeError. Указывает код ошибки поставщика данных, o Number. Указывает номер, однозначно определяющий объект Error, o Source. Указывает имя объекта в котором произошла ошибка, o SQLState. Содержит код состояния SQL для данного объекта Error.
|
