Структура CDaoTableDefInfo

Статья
06/16/2023

Структура содержит сведения о табличном объекте CDaoTableDefInfo , определенном для объектов доступа к данным (DAO).

Синтаксис

struct CDaoTableDefInfo
{
    CString m_strName;               // Primary
    BOOL m_bUpdatable;               // Primary
    long m_lAttributes;              // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    CString m_strSrcTableName;       // Secondary
    CString m_strConnect;            // Secondary
    CString m_strValidationRule;     // All
    CString m_strValidationText;     // All
    long m_lRecordCount;             // All
};

Параметры

m_strName
Уникальное имя объекта tabledef. Чтобы получить значение этого свойства напрямую, вызовите функцию элемента getName объекта tabledef. Дополнительные сведения см. в разделе "Свойство name" в справке DAO.

m_bUpdatable
Указывает, можно ли вносить изменения в таблицу. Быстрый способ определить, является ли таблица обновляемой, — открыть CDaoTableDef объект для таблицы и вызвать функцию-член объекта CanUpdate объекта. CanUpdate всегда возвращает ненулевое значение (TRUE) для только что созданного объекта tabledef и 0 (FALSE) для присоединенного табличного объекта. Новый объект tabledef можно добавить только в базу данных, для которой у текущего пользователя есть разрешение на запись. Если таблица содержит только неустанные поля, CanUpdate возвращает значение 0. Если одно или несколько полей обновляются, CanUpdate возвращает ненулевое значение. Можно изменить только обновляемые поля. Дополнительные сведения см. в разделе "Обновляемое свойство" в справке DAO.

m_lAttributes
Указывает характеристики таблицы, представленной объектом tabledef. Чтобы получить текущие атрибуты табличного элемента, вызовите функцию-член GetAttributes . Возвращаемое значение может быть сочетанием этих длинных констант (с помощью побитового оператора OR):|

dbAttachExclusive Для баз данных, использующих ядро СУБД Microsoft Jet, указывает, что таблица является подключенной таблицей, открытой для монопольного использования.
dbAttachSavePWD Для баз данных, использующих ядро СУБД Microsoft Jet, указывает, что идентификатор пользователя и пароль для подключенной таблицы сохраняются со сведениями о подключении.
dbSystemObject Указывает, что таблица — это системная таблица, предоставляемая ядром СУБД Microsoft Jet. (только для чтения).
dbHiddenObject Указывает, что таблица является скрытой таблицей, предоставляемой ядром СУБД Microsoft Jet (для временного использования). (только для чтения).
dbAttachedTable Указывает, что таблица является присоединенной таблицей из базы данных, отличной от ODBC, например базы данных Paradox.
dbAttachedODBC Указывает, что таблица является присоединенной таблицей из базы данных ODBC, например Microsoft SQL Server.

m_dateCreated
Дата и время создания таблицы. Чтобы напрямую получить дату создания таблицы, вызовите функцию-член GetDateCreated объекта, связанного CDaoTableDef с таблицей. Дополнительные сведения см. в комментариях ниже. Дополнительные сведения см. в разделе "Свойства DateCreated, LastUpdated" в справке DAO.

m_dateLastUpdated
Дата и время последнего изменения, внесенного в структуру таблицы. Чтобы напрямую получить дату последнего обновления таблицы, вызовите функцию CDaoTableDef члена GetDateLastUpdated объекта, связанного с таблицей. Дополнительные сведения см. в комментариях ниже. Дополнительные сведения см. в разделе "Свойства DateCreated, LastUpdated" в справке DAO.

m_strSrcTableName
Указывает имя присоединенной таблицы, если таковой есть. Чтобы напрямую получить имя исходной таблицы, вызовите функцию члена GetSourceTableName объекта, связанного CDaoTableDef с таблицей.

m_strПодключение
Предоставляет сведения об источнике открытой базы данных. Это свойство можно проверка, вызвав функцию элемента Get Подключение объектаCDaoTableDef. Дополнительные сведения о строках подключения см. в статье GetConnect.

m_strValidationRule
Значение, которое проверяет данные в полях табличного значения при их изменении или добавлении в таблицу. Проверка поддерживается только для баз данных, использующих ядро СУБД Microsoft Jet. Чтобы напрямую получить правило проверки, вызовите функцию-член GetValidationRule объекта, связанного CDaoTableDef с таблицей. Дополнительные сведения см. в разделе "Свойство ValidationRule" в справке DAO.

m_strValidationText
Значение, указывающее текст сообщения, которое должно отображаться приложением, если правило проверки, указанное свойством ValidationRule, не удовлетворено. Дополнительные сведения см. в разделе "Свойство ValidationText" в справке DAO.

m_lRecordCount
Количество записей, к которых обращается объект tabledef. Этот параметр свойства доступен только для чтения. Чтобы напрямую получить количество записей, вызовите функцию-член CDaoTableDef GetRecordCount объекта. Документация по GetRecordCount описанию счетчика записей далее. Обратите внимание, что получение этого количества может быть операцией, требующей много времени, если таблица содержит много записей.

Замечания

Tabledef — это объект класса CDaoTableDef. Ссылки на Primary, Secondary и All выше указывают, как информация возвращается функцией-членом GetTableDefInfo в классе CDaoDatabase.

Сведения, полученные функцией-членом CDaoDatabase::GetTableDefInfo , хранятся в CDaoTableDefInfo структуре. GetTableDefInfo Вызовите функцию-член CDaoDatabase объекта, в коллекции TableDefs которого хранится объект tabledef. CDaoTableDefInfo также определяет функцию-член Dump в отладочных сборках. Можно использовать Dump для дампа содержимого объекта CDaoTableDefInfo.

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

Требования

Header: afxdao.h

См. также

Структуры, стили, обратные вызовы и схемы сообщений
Класс CDaoTableDef
Класс CDaoDatabase

Share via