Указывает команду, используемую для обновления (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.
Смотри также
Справочное руководство
Событие BeforeRecordRefreshСвойство KeyFieldList
Свойство RefreshIgnoreFieldList
Свойство RefreshCmdDataSource
Метод RecordRefresh
Свойство Tables
Свойство UpdateNameList