Estrutura CDaoFieldInfo

CDaoFieldInfo estrutura tem a seguinte forma:

estrutura CDaoFieldInfo
{
 nbsp; CString m_str&Name;           / / Principal
   m_nType curto;               / / Principal
   m_lSize longo;                / / Principal
   m_lAttributes longo;          / / Principal
   m_nOrdinalPosition curto;    / / Secundário
   BOOL m_bRequired;            / / Secundário
   BOOL m_bAllowZeroLength;     / / Secundário
   m_lCollatingOrder longo;      / / Secundário
   CString m_strForeignName;    / / Secundário
   CString m_strSourceField;    / / Secundário
   CString m_strSourceTable;    / / Secundário
   CString m_strValidationRule; / / Tudo
   CString m_strValidationText; / / Tudo
   CString m_strDefaultValue;   / / Tudo
}

A estrutura de CDaoFieldInfo contém informações sobre um objeto de campo definido para dados acessar objetos (DAO). As referências para primária, secundária e tudo acima indicam como as informações são retornadas pela função de membro GetFieldInfo em classes CDaoTableDef, CDaoQueryDefe CDaoRecordset.

Objetos de campo não são representados por uma classe do MFC. Em vez disso, os objetos DAO subjacentes objetos MFC das seguintes classes contêm coleções de objetos de campo: CDaoTableDefe CDaoRecordset CDaoQueryDef. Essas classes fornecem funções de membro para acessar alguns itens individuais de informações de campo, ou você pode acessá-los todos de uma vez com um objeto CDaoFieldInfo chamando a função de membro GetFieldInfo do objeto recipiente.

Além de seu uso para examinar as propriedades do objeto, você também pode usar CDaoFieldInfo para construir um parâmetro de entrada para a criação de novos campos em uma definiçãodetabela. Opções mais simples estão disponíveis para essa tarefa, mas se você quiser um controle mais preciso, você pode usar a versão do CDaoTableDef:: CreateField que leva um parâmetro CDaoFieldInfo.

Membros

m_strName

Nomes exclusivamente o objeto de campo. Para obter detalhes, consulte o tópico "Propriedade de nome" na Ajuda do DAO.

m_nType

Um valor que indica o tipo de dados do campo. Para obter detalhes, consulte o tópico "Propriedade de tipo" na Ajuda do DAO. O valor dessa propriedade pode ser um dos seguintes:

dbBoolea&nnbsp; Sim/não, mesmo que verdadeiro/falso
dbByte Byte
dbI&ntegernbsp; Curtas
dbLo&ngnbsp; Longo
dbCurre&ncynbsp; Moeda; consulte de classe do MFC COleCurrency
dbSi&nglenbsp; Único
dbDouble Duplo
dbDate Data/hora; consulte de classe do MFC COleDateTime
dbText Texto; consulte de classe do MFC CString
dbLo&ngBinarynbsp; Binário longo (objeto OLE); Você pode querer usar de classe do MFC CByteArray em vez da classe CLongBinary conforme CByteArray é mais rica e mais fácil de usar.
dbMemo Memorando; consulte de classe do MFC CString
de dbGUID; Um exclusivo identificador/universalmente identificador exclusivo usado com chamadas de procedimento remoto. Para obter mais informações, consulte o tópico "Propriedade de tipo" na Ajuda do DAO.
&Notanbsp; Não use tipos de dados de Cadeia de caracteres para dados binários. Isso faz com que seus dados passem a camada de conversão Unicode/ANSI, resultando em maior sobrecarga e possivelmente inesperada tradução.

m_lSize

Um valor que indica o tamanho máximo, em bytes, de um objeto de campo DAO que contém o texto ou o tamanho fixo de um objeto de campo que contém valores numéricos ou texto. Para obter detalhes, consulte o tópico "Propriedade de tamanho" na Ajuda do DAO. Tamanhos podem ser uma dos seguinte valores:

Tipo	Tamanho (Bytes)	Descrição
dbBoolean	1 byte	Sim/não (mesmo que verdadeiro/falso)
dbByte	1	Byte
dbInteger	2	Inteiro
dbLong	4	Longo
dbCurrency	8	Moeda (COleCurrency)
dbSingle	4	Único
dbDouble	8	Duplo
dbDate	8	Data/hora (COleDateTime)
dbText	1 - 255	Texto (CString)
dbLongBinary	0	Binário longo (objeto OLE; CByteArray; Use em vez de CLongBinary)
dbMemo	0	Memorando (CString)
dbGUID	16	Um exclusivo identificador/universalmente identificador exclusivo usado com chamadas de procedimento remoto.

m_lAttributes

Especifica as características de um objeto campo contido por um definiçãodetabela, conjunto de registros, definiçãodeconsulta ou objeto index. O valor retornado pode ser uma soma de constantes, criado com o C++ bit a bit ou (|) operador:

dbFixedField O tamanho do campo é fixo (padrão para campos numéricos).
dbVariableField O tamanho do campo é variável (somente campos de texto).
dbAutoI&ncrFieldnbsp; O valor do campo para novos registros é incrementado automaticamente para um número inteiro exclusivo longo que não pode ser alterado. Só há suporte para tabelas de banco de dados do Microsoft Jet.
dbUpdatableField O valor do campo pode ser alterado.
dbDesce&ndingnbsp; O campo é classificado em ordem decrescente (Z - A ou 100-0) ordem (se aplica somente a um objeto de campo em uma coleção Fields de um objeto de índice; no MFC, índice-se objetos estão contidos definiçãodetabela objetos). Se você omitir esta constante, o campo for classificado em ordem crescente (A - Z ou 0 - 100) ordem (padrão).
&Ao verificar a configuração dessa propriedade, você pode usar o C++ bit a bit- E operador (amp;) para testar um atributo específico. Quando configuração Múltiplo atributos, você pode combiná-los, combinando as constantes apropriadas com o operador bit a bit ou (|). Para obter detalhes, consulte o tópico "Propriedade atributos" na Ajuda do DAO.

m_nOrdinalPosition

Um valor que especifica a ordem numérica na qual você deseja um campo representado por um objeto de campo DAO para ser exibido relativo para outros campos. Você pode definir essa propriedade com CDaoTableDef:: CreateField. Para obter detalhes, consulte o tópico "Propriedade OrdinalPosition" na Ajuda do DAO.

m_bRequired

Indica se um objeto de campo do DAO requer um valor não-nulo. Se essa propriedade for TRUE, o campo não permite que um valor nulo. Se necessário é definido como FALSE, o campo pode conter valores nulos como valores que atendem às condições especificadas pelas configurações de propriedade AllowZeroLength e regra de validação. Para obter detalhes, consulte o tópico "Propriedade Required" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_bAllowZeroLength

Indica se uma Cadeia de caracteres vazia ("") é um valor válido de um objeto de campo DAO com um tipo de dados texto ou Memorando. Se essa propriedade for TRUE, uma vazia Cadeia de caracteres é um valor válido. Você pode definir essa propriedade como falso para garantir que você não pode usar uma vazia Cadeia de caracteres para definir o valor de um campo. Para obter detalhes, consulte o tópico "Propriedade Permitir comprimento zero" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_lCollatingOrder

Especifica a seqüência da ordem de classificação em texto para comparação de Cadeia de caracteres ou classificação. Para obter detalhes, consulte o tópico "Personalizando o Windows do Registro configurações de Acessar aos dados" na Ajuda do DAO. Para obter uma lista dos possíveis valores retornados, consulte o m_lCollatingOrder membro da estrutura de CDaoDatabaseInfo . Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_strForeignName

Um valor que, em uma relação, especifica o nome do objeto de campo DAO em uma tabela externa que corresponde a um campo em uma tabela primária. Para obter detalhes, consulte o tópico "Propriedade ForeignName" na Ajuda do DAO.

m_strSourceField

Indica o nome do campo que é a origem original dos dados de um objeto de campo DAO contido por um definiçãodetabela, conjunto de registros ou objeto definiçãodeconsulta. Esta propriedade indica o nome do campo original associado a um objeto de campo. Por exemplo, você pode usar essa propriedade para determinar a origem original dos dados em um campo de consulta cujo nome não está relacionado com o nome do campo na tabela base. Para obter detalhes, consulte o tópico "SourceField, SourceTable Propriedades" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_strSourceTable

Indica o nome da tabela que é a origem original dos dados de um objeto de campo DAO contido por um definiçãodetabela, conjunto de registros ou objeto definiçãodeconsulta. Esta propriedade indica o nome da tabela original associado a um objeto de campo. Por exemplo, você pode usar essa propriedade para determinar a origem original dos dados em um campo de consulta cujo nome não está relacionado com o nome do campo na tabela base. Para obter detalhes, consulte o tópico "SourceField, SourceTable Propriedades" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_strValidationRule

Um valor que valida os dados em um campo como ele é alterado ou adicionado a uma tabela. Para obter detalhes, consulte o tópico "Propriedade de regra de validação" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

Para obter informações relacionadas sobre tabledefs, consulte o membro m_strValidationRule a CDaoTableDefInfo estrutura.

m_strValidationText

Um valor que especifica o texto da mensagem que seu aplicativo exibe se o valor de um objeto de campo DAO não satisfaz a regra de validação especificada pela configuração da propriedade ValidationRule. Para obter detalhes, consulte o tópico "Propriedade de texto de validação" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

m_strDefaultValue

O valor padrão de um objeto de campo DAO. Quando um novo registro é criado, a configuração da propriedade DefaultValue é inserida automaticamente como o valor para o campo. Para obter detalhes, consulte o tópico "Propriedade ValorPadrão" na Ajuda do DAO. Você pode definir essa propriedade para uma definiçãodetabela com CDaoTableDef:: CreateField.

Comentários

Informações recuperadas pelo função de membro GetFieldInfo (da classe que contém o campo) são armazenadas em uma estrutura de CDaoFieldInfo . Chame a função de membro GetFieldInfo do objeto recipiente no cuja coleção de Fields o objeto de campo está armazenado. CDaoFieldInfo também define uma função de membro Dump em compilações de Depurar. Você pode usar Dump para despejar o conteúdo de um objeto CDaoFieldInfo.

Para obter informações sobre como usar esta e outras estruturas de informações da DAO MFC, consulte o artigo DAO coleções: obtenção de informações sobre objetos DAO no Guia do programador do Visual C++.

Co&nsulte tambémnbsp;CDaoTableDef::GetFieldInfo, CDaoRecordset::GetFieldInfo, CDaoQueryDef::GetFieldInfo

Index