Share via

Structuur CDaoFieldInfo

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CDaoFieldInfo structuur bevat informatie over een veldobject dat is gedefinieerd voor data access-objecten (DAO).

Opmerking

DAO wordt ondersteund via Office 2013. DAO 3.6 is de definitieve versie en wordt beschouwd als verouderd.

Syntaxis

struct CDaoFieldInfo
{
    CString m_strName;           // Primary
    short m_nType;               // Primary
    long m_lSize;                // Primary
    long m_lAttributes;          // Primary
    short m_nOrdinalPosition;    // Secondary
    BOOL m_bRequired;            // Secondary
    BOOL m_bAllowZeroLength;     // Secondary
    long m_lCollatingOrder;      // Secondary
    CString m_strForeignName;    // Secondary
    CString m_strSourceField;    // Secondary
    CString m_strSourceTable;    // Secondary
    CString m_strValidationRule; // All
    CString m_strValidationText; // All
    CString m_strDefaultValue;   // All
};

Parameterwaarden

m_strName
Noem het veldobject een unieke naam. Zie het onderwerp 'Naameigenschap' in DAO Help voor meer informatie.

m_nType
Een waarde die het gegevenstype van het veld aangeeft. Zie het onderwerp 'Eigenschap type' in DAO Help voor meer informatie. De waarde van deze eigenschap kan een van de volgende zijn:

  • dbBoolean Ja/Nee, hetzelfde als WAAR/ONWAAR

  • dbByte Byte

  • dbInteger Korte

  • dbLong Lange

  • dbCurrency Valuta; zie MFC-klasse COleCurrency

  • dbSingle Één

  • dbDouble Dubbele

  • dbDate Datum/tijd; zie MFC-klasse COleDateTime

  • dbText Tekst; zie MFC-klasse CString

  • dbLongBinary Long Binary (OLE-object); Mogelijk wilt u MFC-klasse CByteArray gebruiken in plaats van klasse CLongBinary , zoals CByteArray rijker en gemakkelijker te gebruiken is.

  • dbMemo Memo; zie MFC-klasse CString

  • dbGUID Een Globally Unique Identifier/Universally Unique Identifier die wordt gebruikt met externe procedure-aanroepen. Zie het onderwerp 'Eigenschap type' in DAO Help voor meer informatie.

Opmerking

Gebruik geen tekenreeksgegevenstypen voor binaire gegevens. Dit zorgt ervoor dat uw gegevens de Unicode-/ANSI-vertaallaag passeren, wat resulteert in een verhoogde overhead en mogelijk onverwachte vertaling.

m_lSize
Een waarde die de maximale grootte in bytes aangeeft van een DAO-veldobject met tekst of de vaste grootte van een veldobject dat tekst of numerieke waarden bevat. Zie het onderwerp 'Grootte-eigenschap' in DAO Help voor meer informatie. Grootten kunnen een van de volgende waarden zijn:

Typologie Grootte (bytes) Description
dbBoolean 1 byte Ja/Nee (hetzelfde als Waar/Onwaar)
dbByte 1 Byte
dbInteger 2 Integer
dbLong 4 Long
dbCurrency 8 Valuta (COleCurrency)
dbSingle 4 Single
dbDouble 8 Dubbel
dbDate 8 Datum/tijd (COleDateTime)
dbText 1 - 255 Tekst (CString)
dbLongBinary 0 Long Binary (OLE-object; CByteArray; gebruiken in plaats van CLongBinary)
dbMemo 0 Memo (CString)
dbGUID 16 Een Globally Unique Identifier/Universally Unique Identifier die wordt gebruikt met externe procedure-aanroepen.

m_lAttributes
Hiermee geeft u kenmerken op van een veldobject dat is opgenomen in een ingediendeef, recordset, querydef of indexobject. De geretourneerde waarde kan een som zijn van deze constanten, gemaakt met de C++-operator bitwise-OR (|):

  • dbFixedField De veldlengte is vast (standaard voor numerieke velden).

  • dbVariableField De veldlengte is variabel (alleen tekstvelden).

  • dbAutoIncrField De veldwaarde voor nieuwe records wordt automatisch verhoogd naar een uniek lang geheel getal dat niet kan worden gewijzigd. Alleen ondersteund voor Microsoft Jet-databasetabellen.

  • dbUpdatableField De veldwaarde kan worden gewijzigd.

  • dbDescending Het veld wordt gesorteerd in aflopende volgorde (Z - A of 100 - 0) (alleen van toepassing op een veldobject in een verzameling velden van een indexobject; in MFC zijn indexobjecten zelf opgenomen in ingediende objecten). Als u deze constante weglaat, wordt het veld gesorteerd in oplopende volgorde (A - Z of 0 - 100) (standaard).

Wanneer u de instelling van deze eigenschap controleert, kunt u de C++ bitwise-AND-operator (&) gebruiken om te testen op een specifiek kenmerk. Wanneer u meerdere kenmerken instelt, kunt u deze combineren door de juiste constanten te combineren met de operator bitwise-OR (|). Zie het onderwerp Kenmerkeneigenschap in DAO Help voor meer informatie.

m_nOrdinalPosition
Een waarde die de numerieke volgorde aangeeft waarin u een veld wilt weergeven dat wordt vertegenwoordigd door een DAO-veldobject ten opzichte van andere velden. U kunt deze eigenschap instellen met CDaoTableDef::CreateField. Zie het onderwerp OrdinalPosition Property in DAO Help voor meer informatie.

m_bRequired
Hiermee wordt aangegeven of een DAO-veldobject een niet-Null-waarde vereist. Als deze eigenschap TRUE is, staat het veld geen Null-waarde toe. Indien vereist is ingesteld op FALSE, kan het veld null-waarden en waarden bevatten die voldoen aan de voorwaarden die zijn opgegeven door de eigenschap AllowZeroLength en ValidationRule. Zie het onderwerp 'Vereiste eigenschap' in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_bAllowZeroLength
Geeft aan of een lege tekenreeks ("") een geldige waarde is van een DAO-veldobject met een gegevenstype Tekst of Memo. Als deze eigenschap TRUE is, is een lege tekenreeks een geldige waarde. U kunt deze eigenschap instellen op FALSE om ervoor te zorgen dat u geen lege tekenreeks kunt gebruiken om de waarde van een veld in te stellen. Zie het onderwerp AllowZeroLength Property in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_lCollatingOrder
Hiermee geeft u de volgorde van de sorteervolgorde in tekst voor tekenreeksvergelijking of sortering op. Zie het onderwerp 'Windows-registerinstellingen voor Gegevenstoegang aanpassen' in DAO Help voor meer informatie. Zie het m_lCollatingOrder lid van de structuur CDaoDatabaseInfo voor een lijst met mogelijke waarden die worden geretourneerd. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_strForeignName
Een waarde die in een relatie de naam van het DAO-veldobject in een refererende tabel aangeeft die overeenkomt met een veld in een primaire tabel. Zie het onderwerp 'ForeignName Property' in DAO Help voor meer informatie.

m_strSourceField
Hiermee wordt de naam aangegeven van het veld dat de oorspronkelijke bron is van de gegevens voor een DAO-veldobject dat is opgenomen in een ingediendeef-, recordset- of querydef-object. Deze eigenschap geeft de oorspronkelijke veldnaam aan die is gekoppeld aan een veldobject. U kunt deze eigenschap bijvoorbeeld gebruiken om de oorspronkelijke bron van de gegevens in een queryveld te bepalen waarvan de naam niet is gerelateerd aan de naam van het veld in de onderliggende tabel. Zie het onderwerp 'SourceField, SourceTable Properties' in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_strSourceTable
Hiermee wordt de naam aangegeven van de tabel die de oorspronkelijke bron is van de gegevens voor een DAO-veldobject dat is opgenomen in een ingediendeef-, recordset- of querydef-object. Deze eigenschap geeft de oorspronkelijke tabelnaam aan die is gekoppeld aan een veldobject. U kunt deze eigenschap bijvoorbeeld gebruiken om de oorspronkelijke bron van de gegevens in een queryveld te bepalen waarvan de naam niet is gerelateerd aan de naam van het veld in de onderliggende tabel. Zie het onderwerp 'SourceField, SourceTable Properties' in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_strValidationRule
Een waarde waarmee de gegevens in een veld worden gevalideerd wanneer deze worden gewijzigd of toegevoegd aan een tabel. Zie het onderwerp Validatieregeleigenschap in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

Zie het lid van de m_strValidationRulestructuur CDaoTableDefInfo voor gerelateerde informatie over tabledefs.

m_strValidationText
Een waarde die de tekst opgeeft van het bericht dat uw toepassing weergeeft als de waarde van een DAO-veldobject niet voldoet aan de validatieregel die is opgegeven door de instelling van de eigenschap ValidationRule. Zie het onderwerp Validatieteksteigenschap in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

m_strDefaultValue
De standaardwaarde van een DAO-veldobject. Wanneer er een nieuwe record wordt gemaakt, wordt de eigenschap DefaultValue automatisch ingevoerd als de waarde voor het veld. Zie het onderwerp DefaultValue Property in DAO Help voor meer informatie. U kunt deze eigenschap instellen voor een ingediendeef met CDaoTableDef::CreateField.

Opmerkingen

De verwijzingen naar Primary, Secondary en All above geven aan hoe de informatie wordt geretourneerd door de GetFieldInfo lidfunctie in klassen CDaoTableDef, CDaoQueryDef en CDaoRecordset.

Veldobjecten worden niet vertegenwoordigd door een MFC-klasse. In plaats daarvan bevatten de DAO-objecten onderliggende MFC-objecten van de volgende klassen verzamelingen veldobjecten: CDaoTableDef, CDaoRecordset en CDaoQueryDef. Deze klassen bieden lidfuncties voor toegang tot bepaalde afzonderlijke items met veldgegevens, of u kunt ze allemaal tegelijk openen met een CDaoFieldInfo object door de GetFieldInfo lidfunctie van het betreffende object aan te roepen.

Naast het gebruik ervan voor het onderzoeken van objecteigenschappen, kunt u ook een CDaoFieldInfo invoerparameter maken voor het maken van nieuwe velden in een ingediendeef. Er zijn eenvoudigere opties beschikbaar voor deze taak, maar als u meer controle wilt, kunt u de versie van CDaoTableDef::CreateField gebruiken die een CDaoFieldInfo parameter gebruikt.

Informatie die wordt opgehaald door de GetFieldInfo lidfunctie (van de klasse die het veld bevat) wordt opgeslagen in een CDaoFieldInfo structuur. Roep de GetFieldInfo lidfunctie aan van het bevatde object in de veldenverzameling waarin het veldobject is opgeslagen. CDaoFieldInfo definieert ook een Dump lidfunctie in builds voor foutopsporing. U kunt Dump de inhoud van een CDaoFieldInfo object dumpen.

Requirements

Rubriek:afxdao.h

Zie ook

Structuren, stijlen, callbacks en berichttoewijzingen
CDaoTableDef::GetFieldInfo
CDaoRecordset::GetFieldInfo
CDaoQueryDef::GetFieldInfo

  • Last updated on