CDaoFieldInfo struktúra

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A CDaoFieldInfo struktúra adatokat tartalmaz az adatelérési objektumokhoz (DAO) definiált mezőobjektumokról.

Megjegyzés:

A DAO az Office 2013-on keresztül támogatott. A DAO 3.6 a végleges verzió, és elavultnak számít.

Szemantika

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

Paraméterek

m_strName
Egyedileg nevezze el a mezőobjektumot. További részletekért tekintse meg a DAO súgójának "Névtulajdonság" című témakörét.

m_nType
A mező adattípusát jelző érték. További részletekért tekintse meg a DAO súgójának "Típustulajdonság" című témakörét. A tulajdonság értéke a következők egyike lehet:

• dbBoolean Igen/Nem, ugyanaz, mint IGAZ/HAMIS

• dbByte Bájt

• dbInteger Rövid

• dbLong Hosszú

• dbCurrency Pénznem; lásd: MFC-osztály COleCurrency

• dbSingle Egyetlen

• dbDouble Dupla

• dbDate Dátum/idő; lásd: MFC-osztály: COleDateTime

• dbText Szöveg; lásd: MFC-osztály CString

• dbLongBinary Hosszú bináris (OLE-objektum); érdemes lehet az MFC CByteArray osztályt használni az osztály CLongBinary helyett, mivel CByteArray gazdagabb és könnyebben használható.

• dbMemo Kamatszámla; lásd: MFC-osztály CString

• dbGUID A távoli eljáráshívásokhoz használt globálisan egyedi azonosító/univerzálisan egyedi azonosító. További információ: "Típustulajdonság" a DAO súgójában.

Megjegyzés:

Ne használjon sztring adattípusokat bináris adatokhoz. Ez azt eredményezi, hogy az adatok áthaladnak a Unicode/ANSI fordítási rétegen, ami nagyobb többletterhelést és esetleg váratlan fordítást eredményez.

m_lSize
Olyan érték, amely egy szövegeket vagy numerikus értékeket tartalmazó DAO-mezőobjektum maximális méretét jelzi bájtban. További részletekért tekintse meg a DAO súgójának "Mérettulajdonság" című témakörét. A méretek a következő értékek egyike lehetnek:

Típus	Méret (bájt)	Description
dbBoolean	1 bájt	Igen/Nem (ugyanaz, mint igaz/hamis)
dbByte	1	Byte
dbInteger	2	Egész szám
dbLong	4	Hosszú
dbCurrency	8	Pénznem (COleCurrency)
dbSingle	4	Single
dbDouble	8	Double
dbDate	8	Dátum/idő (COleDateTime)
dbText	1 - 255	Szöveg (CString)
dbLongBinary	0	Hosszú bináris (OLE objektum; CByteArray; használata helyett CLongBinary)
dbMemo	0	Feljegyzés (CString)
dbGUID	16	A távoli eljáráshívásokhoz használt globálisan egyedi azonosító/univerzálisan egyedi azonosító.

m_lAttributes
A tábla, a rekordhalmaz, a lekérdezésdef vagy az indexobjektum által tartalmazott mezőobjektum jellemzőit határozza meg. A visszaadott érték a C++ bitenkénti-OR (|) operátorral létrehozott állandók összege lehet:

• dbFixedField A mezőméret rögzített (numerikus mezők esetén alapértelmezés szerint).

• dbVariableField A mezőméret változó (csak szövegmezők esetén).

• dbAutoIncrField Az új rekordok mezőértéke automatikusan egyedi hosszú egész számra nő, amely nem módosítható. Csak Microsoft Jet-adatbázistáblák esetén támogatott.

• dbUpdatableField A mező értéke módosítható.

• dbDescending A mező csökkenő (Z – A vagy 100 – 0) sorrendben van rendezve (csak egy indexobjektum Mezőgyűjteményének mezőobjektumára vonatkozik; az MFC-ben az indexobjektumok maguk is táblázatos objektumokban találhatók). Ha kihagyja ezt az állandót, a mező növekvő (A – Z vagy 0 – 100) sorrendben lesz rendezve (alapértelmezett).

A tulajdonság beállításának ellenőrzésekor a C++ bitenkénti ÉS operátor (&) használatával tesztelheti egy adott attribútumot. Több attribútum beállításakor kombinálhatja őket a megfelelő állandók bitenkénti VAGY (|) operátorral való kombinálásával. További részletekért tekintse meg az Attribútumok tulajdonsága című témakört a DAO súgójában.

m_nOrdinalPosition
Olyan érték, amely megadja azt a numerikus sorrendet, amelyben egy DAO-mezőobjektum által képviselt mező más mezőkhöz viszonyítva jelenik meg. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be. További részletekért tekintse meg a DAO súgójának "OrdinalPosition Property" (OrdinalPosition tulajdonság) című témakörét.

m_bRequired
Azt jelzi, hogy egy DAO-mezőobjektum nem null értéket igényel-e. Ha ez a tulajdonság IGAZ, a mező nem engedélyezi a Null értéket. Ha a Kötelező érték ÉRTÉKE HAMIS, a mező tartalmazhat null értékeket, valamint az AllowZeroLength és ValidationRule tulajdonságbeállítások által megadott feltételeknek megfelelő értékeket. További részletekért tekintse meg a DAO súgójának "Kötelező tulajdonság" című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_bAllowZeroLength
Azt jelzi, hogy egy üres sztring ("") egy DAO-mezőobjektum érvényes értéke szöveg vagy feljegyzés típusú adattípussal. Ha ez a tulajdonság IGAZ, az üres sztring érvényes érték. Ezt a tulajdonságot HAMIS értékre állíthatja, hogy ne használjon üres sztringet egy mező értékének beállításához. További részletekért tekintse meg az "AllowZeroLength tulajdonság" témakört a DAO súgójában. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_lCollatingOrder
Megadja a rendezési sorrend sorrendjét a szövegben a sztringek összehasonlításához vagy rendezéséhez. További részletekért tekintse meg a DAO súgójának "A Windows beállításjegyzék-beállításainak testreszabása az adathozzáféréshez" című témakört. A visszaadott lehetséges értékek listájáért tekintse meg a m_lCollatingOrderCDaoDatabaseInfo struktúra tagját. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_strForeignName
Egy olyan érték, amely egy relációban egy idegen tábla DAO-mezőobjektumának nevét adja meg, amely egy elsődleges tábla egy mezőjének felel meg. További részletekért tekintse meg a DAO súgójának "ForeignName Tulajdonság" című témakörét.

m_strSourceField
Annak a mezőnek a nevét jelzi, amely egy tábla, rekordhalmaz vagy querydef objektum által tartalmazott DAO-mezőobjektum adatainak eredeti forrása. Ez a tulajdonság egy mezőobjektumhoz társított eredeti mezőnevet jelzi. Ezt a tulajdonságot használhatja például az adatok eredeti forrásának meghatározására egy olyan lekérdezésmezőben, amelynek a neve nem kapcsolódik az alapul szolgáló tábla mezőjének nevéhez. További részletekért tekintse meg a DAO súgójának "SourceField, SourceTable Properties" (Forrásmező, Forrástábla tulajdonságai) című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_strSourceTable
Annak a táblának a nevét jelzi, amely egy tábla, rekordhalmaz vagy querydef objektum által tartalmazott DAO-mezőobjektum adatainak eredeti forrása. Ez a tulajdonság egy mezőobjektumhoz társított eredeti táblanevet jelzi. Ezt a tulajdonságot használhatja például az adatok eredeti forrásának meghatározására egy olyan lekérdezésmezőben, amelynek a neve nem kapcsolódik az alapul szolgáló tábla mezőjének nevéhez. További részletekért tekintse meg a DAO súgójának "SourceField, SourceTable Properties" (Forrásmező, Forrástábla tulajdonságai) című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_strValidationRule
Olyan érték, amely ellenőrzi egy mező adatait, miközben azokat módosítják vagy hozzáadják egy táblához. További részletekért tekintse meg a DAO súgójának "ValidationRule tulajdonsága" című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

A táblázatokkal kapcsolatos információkért lásd a m_strValidationRuleCDaoTableDefInfo struktúra tagját.

m_strValidationText
Az alkalmazás által megjelenített üzenet szövegét meghatározó érték, ha egy DAO-mezőobjektum értéke nem felel meg az ValidationRule tulajdonságbeállítás által megadott érvényesítési szabálynak. További részletekért tekintse meg a DAO súgójának "ValidationText Tulajdonság" című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

m_strDefaultValue
Egy DAO-mezőobjektum alapértelmezett értéke. Új rekord létrehozásakor a DefaultValue tulajdonság beállítása automatikusan meg lesz adva a mező értékeként. További részletekért tekintse meg a DAO súgójának "DefaultValue tulajdonsága" című témakörét. Ezt a tulajdonságot a CDaoTableDef::CreateField beállítással állíthatja be a tabledefhez.

Megjegyzések

Az elsődleges, a másodlagos és az összes fenti hivatkozás azt jelzi, hogy a CDaoTableDef, a CDaoQueryDef és a GetFieldInfoCDaoRecordset osztály tagfüggvénye hogyan adja vissza az adatokat.

A mezőobjektumokat nem MFC-osztály jelöli. Ehelyett a következő osztályok MFC-objektumait tartalmazó DAO-objektumok mezőobjektum-gyűjteményeket tartalmaznak: CDaoTableDef, CDaoRecordset és CDaoQueryDef. Ezek az osztályok tagfüggvényeket adnak a mezőadatok egyes elemeinek eléréséhez, vagy egyszerre egy objektummal CDaoFieldInfo is elérheti őket az GetFieldInfo adott objektum tagfüggvényének meghívásával.

Az objektumtulajdonságok vizsgálatára való használata mellett egy bemeneti paramétert is létrehozhat CDaoFieldInfo új mezők létrehozására a táblázatterületen. Ennél a feladatnál egyszerűbb beállítások érhetők el, de ha finomabb vezérlést szeretne, használhatja a CDaoTableDef::CreateField paramétert CDaoFieldInfo használó verzióját.

A tagfüggvény (a mezőt tartalmazó osztály) által GetFieldInfo lekért információk egy CDaoFieldInfo struktúrában lesznek tárolva. Hívja meg annak az GetFieldInfo objektumnak a tagfüggvényét, amelyben a Mező gyűjtemény a mezőobjektumot tárolja. CDaoFieldInfo emellett definiál egy tagfüggvényt Dump a hibakeresési buildekben. Az objektum tartalmának kiírására CDaoFieldInfo is használhatóDump.

Requirements

Fejléc:afxdao.h

Lásd még

Struktúrák, stílusok, visszahívások és üzenettérképek
CDaoTableDef::GetFieldInfo
CDaoRecordset::GetFieldInfo
CDaoQueryDef::GetFieldInfo