Присоединяет существующий курсор к текущей инстанции объекта CursorAdapter.

CursorAdapter.CursorAttach( [ cAlias [, lInheritCursorProperties ] ] )

Параметры

cAlias

Указывает псевдоимя присоединяемого курсора или таблицы.

Когда указан cAlias, CursorAttach заполняет свойство Alias объекта CursorAdapter псевдоименем присоединяемого курсора или таблицы. Когда cAlias не указан, объект CursorAttach пытается присоединить курсор или таблицу, которые должны существовать, основываясь на текущем значеним свойства Alias .

lInheritCursorProperties

Указывает, желаете ли вы сохранить или сбросить свойства присоедняемых курсора или таблицы. В приведенной ниже таблицы перечислены возможные значения для lInheritCursorProperties с описанием поведения.

lInheritCursorProperties Описание

True (.T.)

Существующий набор свойств курсора или таблицы наследуется соответствующими свойствами объекта CursorAdapter.

False (.F.) or empty

Существующий набор свойств курсора или таблицы не копируется в соответствующие свойства объекта CursorAdapter.

Эта опция добавляет определенную гибкость, когда вы присоединяете SQL Pass-Through, удаленное представление или прочий курсор.

Expand imageВозвращаемое значение

Логический тип данных. CursorAttach возвращает True (.T.), если операция присоединения курсора завершилась успешно, в противном случае False (.F.).

NoteЗамечание

Для получения информации об ошибке, если операция присоединения не завершилась успехом, вы должны вызвать функцию AERROR( ), так как обработчики ошибок Visual Foxpro, такие, как команда ON ERROR, событие Error и команда TRY...CATCH...FINALLY не ловят эту ошибку.

Expand imageПримечания

Применяется к : классу CursorAdapter

Курсор или таблица могут иметь только одну инстанцию объекта CursorAdapter, к которому они подсоединены в любой момент времени.

Когда Visual FoxPro присоединит курсор к объекту курсор-адаптера, вы не можете изменять свойства курсора или таблицы с помошью команд MODIFY STRUCTURE или SQL ALTER TABLE.

Вызов метода CursorAttach закрывает текущий присоединенный курсор. Для сохранения текущего присоединенного курсора открытым, перед вызовом метода CursorAttach вызовите метод CursorDetach.

Вызов метода CursorAttach заполняет свойство Alias инстанции CursorAdapter псевдоименем присоединяемого курсора или таблицы.

Вызов метода CursorAttach включает режим BufferModeOverride(3) или BufferModeOverride(5) в зависимости от значения свойства BufferModeOverride объекта CursorAdapter, если он еще не установлен. Если режим буфферирования уже включен, но он меньше, по значению, чем Optimistic Row Buffering, Visual FoxPro повышает буфферирование до Optimistic Row Buffering.

Visual FoxPro генерирует сообщение об ошибке в следующих случаях:

  • cAlias не найден.

  • Если CursorAttach пытается присоединить курсор, который уже присоединен к другой инстанции CursorAdapter.

Свойство Tables не должно ссылаться на курсор уже присоединенный к объекту CursorAdapter с помощью метода CursorAttach.

Expand image Смотрите также