Estrutura CDaoRelationInfo

A CDaoRelationInfo estrutura contém informação sobre uma relação definida entre corpos de duas tabelas num CDaoDatabase objeto.

Sintaxe

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
};

Parâmetros

m_strName
Nomeia de forma única o objeto de relação. Para mais informações, consulte o tópico "Nome de Propriedade" no DAO Help.

m_strTable
Nomeia a tabela principal na relação.

m_strForeignTable
Nomeia a tabela estrangeira na relação. Uma tabela estrangeira é uma tabela usada para conter chaves estrangeiras. Geralmente, utiliza-se uma tabela estrangeira para estabelecer ou impor integridade referencial. A mesa estrangeira está geralmente do lado múltiplo de uma relação um-para-muitos. Exemplos de tabelas estrangeiras incluem tabelas contendo códigos dos estados americanos ou províncias canadianas ou encomendas de clientes.

m_lAttributes
Contém informação sobre o tipo de relação. O valor deste membro pode ser qualquer um dos seguintes:

• dbRelationUnique A relação é um para um.

• dbRelationDontEnforce A relação não é imposta (sem integridade referencial).

• dbRelationInherited A relação existe numa base de dados não atual que contém as duas tabelas anexadas.

• dbRelationLeft A relação é uma união à esquerda. Uma junção exterior à esquerda inclui todos os registos da primeira (à esquerda) de duas tabelas, mesmo que não existam valores correspondentes para registos na segunda tabela (à direita).

• dbRelationRight A relação é uma união à direita. Uma junção exterior à direita inclui todos os registos da segunda (direita) de duas tabelas, mesmo que não existam valores correspondentes para registos na primeira tabela (da esquerda).

• dbRelationUpdateCascade As atualizações irão surgir em cascata.

• dbRelationDeleteCascade As eliminações vão acontecer em cascata.

m_pFieldInfos
Um apontador para um array de estruturas CDaoRelationFieldInfo . O array contém um objeto para cada campo na relação. O m_nFields elemento de dados fornece uma contagem dos elementos do array.

m_nFields
O número de CDaoRelationFieldInfo objetos no m_pFieldInfos membro de dados.

Observações

As referências a Primário e Secundário acima indicam como a informação é devolvida pela função membro GetRelationInfo na classe CDaoDatabase.

Os objetos de relação não são representados por uma classe MFC. Em vez disso, o objeto DAO subjacente a um objeto MFC da CDaoDatabase classe mantém uma coleção de objetos de relação: CDaoDatabase fornece funções membros para aceder a alguns itens individuais de informação de relação, ou pode aceder a todos de uma vez com um CDaoRelationInfo objeto chamando a GetRelationInfo função membro do objeto de base de dados que contém.

A informação recuperada pela função membro CDaoDatabase::GetRelationInfo é armazenada numa CDaoRelationInfo estrutura. CDaoRelationInfo também define uma Dump função membro em builds de depuração. Podes usar Dump para despejar o conteúdo de um CDaoRelationInfo objeto.

Requerimentos

Cabeçalho:afxdao.h

Consulte também

Estrutura CDaoRelationFieldInfo