Структура CDaoQueryDefInfo

Статья
02/20/2013

Структура CDaoQueryDefInfo содержащий сведения об объекте QueryDef указанном для объектов доступа к данным (DAO).

struct CDaoQueryDefInfo
{
   CString m_strName;               // Primary
   short m_nType;                   // Primary
   COleDateTime m_dateCreated;      // Secondary
   COleDateTime m_dateLastUpdated;  // Secondary
   BOOL m_bUpdatable;               // Secondary
   BOOL m_bReturnsRecords;          // Secondary
   CString m_strSQL;                // All
   CString m_strConnect;            // All
   short m_nODBCTimeout;            // All
};

Параметры

m_strName
Уникальные имена объект QueryDef.Дополнительные сведения см. в разделе «свойство» имя» в Справке DAO.Вызов CDaoQueryDef::GetName для получения это свойство напрямую.

m_nType
Значение, указывающее рабочий QueryDef тип объекта.Значение может быть одним из следующих:

dbQSelect select — запрос выбирает записи.
Действие dbQAction — запрос или перемещаются данные изменений, но не возвращают записи.
dbQCrosstab Crosstab — запрос возвращает данные в виде табличной формат.
Удаление dbQDelete — запрос удаляет набор указанных строк.
Обновление dbQUpdate — изменении запроса набора записей.
Добавление dbQAppend — запрос добавляет новые записи в конец таблицы или запроса.
Делать-таблица dbQMakeTable — запрос создает новую таблицу из набора записей.
Определение данных dbQDDL— запрос влияет на структуру таблиц или их частей.
dbQSQLPassThrough передаваемые — инструкция SQL передается непосредственно к серверной базы данных, без промежуточную обработку.
Соединение dbQSetOperation — запрос создает объект набора записей является моментальным снимок-типа, содержащий данные из всех указанных записей в двух или более таблицах со всеми удаленными повторяющимися записи.Чтобы разрешить дубликаты, добавьте ключевое слово ВСЕ в инструкции SQL QueryDef.
dbQSPTBulk, используемый с dbQSQLPassThrough чтобы задать запрос, который не возвращает записи.

Примечание
Чтобы создать запрос к серверу SQL, не заданы dbQSQLPassThrough постоянным.Это задается автоматически database engine Microsoft jet при создании объекта QueryDef и задать свойство соединения.

Дополнительные сведения см. в разделе «свойство» тип» в Справке DAO.

m_dateCreated
Дата и время QueryDef было создано.Напрямую для получения дата создания QueryDef GetDateCreated вызовите функцию-член объекта CDaoTableDef, связанного с таблицей.См. примечания ниже дополнительные сведения.См. также раздел «DateCreated свойства LastUpdated» в Справке DAO.
m_dateLastUpdated
Дата и время самого последнего выполненного изменения QueryDef.Напрямую для получения дата последнего обновления таблицы, вызовите функцию-член GetDateLastUpdated QueryDef.См. примечания ниже дополнительные сведения.См. раздел «и DateCreated свойства LastUpdated» в Справке DAO.
m_bUpdatable
Указывает, можно вносить изменения в объект QueryDef.Если это свойство Истина, то QueryDef быть обновляемым; в противном случае – нет.Определение запроса объекта, означает, что QueryDef можно изменить.Обновляемое свойство объекта QueryDef имеет значение Истина если определение запроса можно обновить, даже если результирующий набор записей не является обновляемым.Чтобы получить это свойство напрямую, вызовите функцию-член CanUpdate QueryDef.Дополнительные сведения см. в подразделе «обновляемое свойство» в Справке DAO.
m_bReturnsRecords
Показывает, возвращает ли запрос к серверу SQL к внешней базе данных записи.Если это свойство Истина, то запрос получает записи.Прямой вызов CDaoQueryDef::GetReturnsRecords получить это свойство.Не все запросы на сервер SQL с внешними базами данных возвращают записи.Например, оператор UPDATE SQL обновляет записи без возвращения записей, тогда как оператор выбрать SQL возвращает записи.Дополнительные сведения см. в разделе «свойство ReturnsRecords» в Справке DAO.
m_strSQL
Инструкция SQL, указывающее запрос была выполнена объектом QueryDef.Свойство SQL содержит инструкцию SQL, определяющее, как выделены, группируются и упорядочиваются записи при выполнении запроса.Можно использовать запрос, чтобы выбрать записи для включения в объекте набора записей динамического подмножества данных или моментальный снимок-типа.Также можно указать массовых запросов для изменения данных без возвращения записей.Можно извлечь значение этого свойства непосредственно, вызвав функцию-член GetSQL QueryDef.
m_strConnect
Предоставляет сведения об источнике базы данных, используемой в запросе к серверу.Эти сведения принимает форму строки подключения.Дополнительные сведения о подключении строки и сведения о восстановлении значение этого свойства непосредственно см. CDaoDatabase::GetConnect функции-члена.
m_nODBCTimeout
Число секунд, в течение которых ядро СУБД Microsoft jet ожидает, прежде чем ошибка времени ожидания происходит, если запрос выполняется на базе данных ODBC.При использовании база данных ODBC, например Microsoft SQL Server, могут возникнуть из-за задержки сетевого трафика или тяжелой использования сервера ODBC.Вместо ожидания бесконечно, можно указать, как долго database engine Jet (Майкрософт) ожидает, прежде чем он вызывает ошибку.Значение времени ожидания по умолчанию составляет 60 секунд.Можно извлечь значение этого свойства непосредственно, вызвав функцию-член GetODBCTimeout QueryDef.Дополнительные сведения см. в разделе «свойство ODBCTimeout» в Справке DAO.

Заметки

QueryDef объект класса CDaoQueryDef.Ссылки на первичный и вторичный и всем выше показано, как сведения возвращаются функцией-членом GetQueryDefInfo в классе CDaoDatabase.

Сведения извлеченное функцией-членом CDaoDatabase::GetQueryDefInfo хранится в структуре CDaoQueryDefInfo.Вызовите GetQueryDefInfo для объекта базы данных, в котором хранится объект коллекции QueryDefs QueryDef.CDaoQueryDefInfo также определяет функции-члена Dump в отладочные построения.Можно использовать Dump чтобы сбросить содержимое объекта CDaoQueryDefInfo.Функции-членам класса CDaoDatabase предоставляет также для прямого доступа к все свойства, возвращаемые в объекте CDaoQueryDefInfo редко, поэтому возможно, будет необходимо вызвать GetQueryDefInfo.

При добавлении новых поля или объект параметра в коллекции полей или параметров объекта QueryDef, вызывается исключение, если основная база данных не поддерживают тип данных, указанный для нового объекта.

Параметры даты и времени производными от компьютера, на котором было создано QueryDef или обновленного последнего.В многопользовательской среде, пользователи должны получить эти параметры непосредственно из файлового сервера с помощью команды NET TIME избежать несоответствия в свойстве DateCreated параметры и LastUpdated.