Структура CDaoRelationInfo

Статья
10/12/2023

Структура CDaoRelationInfo содержит сведения о связи, определенной между полями двух таблиц в объекте CDaoDatabase .

Синтаксис

struct CDaoRelationInfo
{
    CDaoRelationInfo();                     // Constructor
    CString m_strName;                      // Primary
    CString m_strTable;                     // Primary
    CString m_strForeignTable;              // Primary
    long m_lAttributes;                     // Secondary
    CDaoRelationFieldInfo* m_pFieldInfos;   // Secondary
    short m_nFields;                        // Secondary
    // Below the // Implementation comment:
    // Destructor, not otherwise documented
};

Параметры

m_strName
Уникально присваивает имя объекту реляционной связи. Дополнительные сведения см. в разделе "Свойство name" в справке DAO.

m_strTable
Именует основную таблицу в связи.

m_strForeignTable
Именует внешнюю таблицу в связи. Внешняя таблица — это таблица, используемая для хранения внешних ключей. Как правило, вы используете внешнюю таблицу для установления или принудительной целостности ссылок. Иностранная таблица обычно находится на многих сторонах отношения "один ко многим". Примеры иностранных таблиц включают таблицы, содержащие коды для американских штатов или канадских провинций или заказов клиентов.

m_lAttributes
Содержит сведения о типе отношения. Значение этого элемента может быть любым из следующих значений:

dbRelationUnique Отношение одно к одному.
dbRelationDontEnforce Связь не применяется (нет ссылочной целостности).
dbRelationInherited Связь существует в некурсной базе данных, содержащей две присоединенные таблицы.
dbRelationLeft Связь — это левое соединение. Левое внешнее соединение включает все записи из первой (левой) из двух таблиц, даже если в второй (правой) таблице отсутствуют соответствующие значения.
dbRelationRight Отношение является правильным соединением. Правое внешнее соединение включает все записи из второй (правой части) двух таблиц, даже если в первой (левой) таблице отсутствуют соответствующие значения.
dbRelationUpdateCascadeОбновления будет каскадным.
dbRelationDeleteCascade Удаление будет каскадным.

m_pFieldInfos
Указатель на массив структур CDaoRelationFieldInfo . Массив содержит один объект для каждого поля в связи. Элемент m_nFields данных предоставляет количество элементов массива.

m_nFields
Количество CDaoRelationFieldInfo объектов в элементе m_pFieldInfos данных.

Замечания

Ссылки на primary и Secondary выше указывают, как информация возвращается функцией-членом GetRelationInfo в классе CDaoDatabase.

Реляционные объекты не представлены классом MFC. Вместо этого объект DAO, лежащий в основе объекта CDaoDatabase MFC класса, поддерживает коллекцию реляционных объектов: CDaoDatabase предоставляет функции-члены для доступа к некоторым отдельным элементам реляционной информации или вы можете получить доступ ко всем ним одновременно с CDaoRelationInfo объектом, вызвав GetRelationInfo функцию-член содержащего объекта базы данных.

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

Требования

Header: afxdao.h

См. также

Структура CDaoRelationFieldInfo

Share via