Указывает команду, используемую для обновления (Refresh) записи производимого методом RecordRefresh. Редактируемое (Read/write) в design и run time.

CursorAdapter.RefreshCmd[ = cCommand]

Параметры

cCommand

Символьный тип данныъ. В приведенной ниже таблицы перечислены возможные значения для cCommand.

cCommand Описание

Символьная строка или выражение

Указывает действительную команду для источника данных определенного свойствами RefreshCmdDataSourceType и RefreshCmdDataSource.

Для источников данных типа ADO и ODBC, вы можете указать любую команду, поддерживаемую источником данных и возвращающую только одну запись.

Для "родных" Visual FoxPro источников данных - Native, команда должна быть командой SQL SELECT, которая возвращает только одну запись. Поля Fields are matched by their position in the cursor за исключением полей, перечисленных в значении свойства RefreshIgnoreFieldList.

Пустая строка ("")

В этом случае объект CursorAdapter автоматически генерирует команду обновления (Refresh).

Генерируемая команда основывается на источнике данных и значениях свойств Tables, KeyFieldList, UpdateNameList и RefreshIgnoreFieldList объекта CursorAdapter. Если вы сами составите команду, то значения свойств Tables, KeyFieldList и UpdateNameList properties игнорируются.

Замечание:
Команда, которая генерируется автоматически объектом CursorAdapter, не включает в себя полей AUTOINC или ключевых полей, даже если они не включены в список, внесенный в свойство RefreshIgnoreFieldList.

Примечания

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

Команда, которую вы укажете в значении этого свойства, исполняется для каждой целевой записи. Проверочные правила (Validation rules) для целевых полей в этом случае не исполняются!.

В случае, если в процессе (refresh) обновления произошла ошибка, обновления полей не происходит. Ошибка генерируется и в случае, если не поддерживается трансляция данных из поля источника в целевое поле. Попытка обновить поле AUTOINC также вызовет генерацию ошибки. Операция обновления прекращается и в случае, если не удалось обновить индексы, вследствие неуникальность ключа или по какой-либо иной причине.

Для ADODB Recordset'ов, свойства RefreshCmd, Tables, KeyFieldList и UpdateNameList объекта CursorAdapter игнорируются и не генерируется ошибка, если не указаны ключевые поля.

Если тип блокировки для ADODB Recordset не соответствует adLockBatchOptimistic или adLockUnspecified, CursorAdapter вызывает метод Resync Method с параметром ResyncValues установленным в adResyncAllValues для обновления (refresh) записи в Recordset до обновления (refresh) записи в курсоре.

Вы может установить значение этого свойства в методе, ассоциированном с событием BeforeRecordRefresh.

Смотри также