Megosztás a következőn keresztül:

CDaoTableDef osztály

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.

Egy alaptábla vagy egy csatolt tábla tárolt definícióját jelöli.

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

class CDaoTableDef : public CObject

Tagok

Nyilvános konstruktorok

Név Description
CDaoTableDef::CDaoTableDef Egy CDaoTableDef objektumot hoz létre.

Nyilvános metódusok

Név Description
CDaoTableDef::Append Új táblát ad hozzá az adatbázishoz.
CDaoTableDef::CanUpdate Nonzero értéket ad vissza, ha a tábla frissíthető (módosíthatja a mezők definícióját vagy a táblatulajdonságokat).
CDaoTableDef::Close Bezár egy megnyitott táblázatot.
CDaoTableDef::Létrehozás Létrehoz egy táblát, amely hozzáfűzhető az adatbázishoz.
CDaoTableDef::CreateField Egy tábla mezőinek létrehozásához van meghívva.
CDaoTableDef::CreateIndex Egy tábla indexének létrehozásához hívták meg.
CDaoTableDef::D eleteField Egy tábla mezőinek törlésére van meghívva.
CDaoTableDef::D eleteIndex Index törlésére van meghívva egy táblából.
CDaoTableDef::GetAttributes Egy objektum egy vagy több jellemzőjét CDaoTableDef jelző értéket ad vissza.
CDaoTableDef::GetConnect Olyan értéket ad vissza, amely egy tábla forrásáról nyújt információt.
CDaoTableDef::GetDateCreated Az objektum alapjául szolgáló CDaoTableDef alaptábla létrehozásának dátumát és időpontját adja vissza.
CDaoTableDef::GetDateLastUpdated Az alaptábla kialakításában végrehajtott legutóbbi módosítás dátumát és időpontját adja vissza.
CDaoTableDef::GetFieldCount Olyan értéket ad vissza, amely a tábla mezőinek számát jelöli.
CDaoTableDef::GetFieldInfo A tábla mezőivel kapcsolatos konkrét információkat ad vissza.
CDaoTableDef::GetIndexCount A tábla indexeinek számát adja vissza.
CDaoTableDef::GetIndexInfo A tábla indexeiről adott típusú információkat ad vissza.
CDaoTableDef::GetName A tábla felhasználó által megadott nevét adja vissza.
CDaoTableDef::GetRecordCount A tábla rekordjainak számát adja vissza.
CDaoTableDef::GetSourceTableName A forrásadatbázis csatolt táblájának nevét meghatározó értéket ad vissza.
CDaoTableDef::GetValidationRule Egy olyan értéket ad vissza, amely ellenőrzi egy mező adatait, miközben azokat módosítják vagy hozzáadják egy táblához.
CDaoTableDef::GetValidationText Olyan értéket ad vissza, amely megadja az alkalmazás által megjelenített üzenet szövegét, ha egy Mező objektum értéke nem felel meg a megadott érvényességi szabálynak.
CDaoTableDef::IsOpen Nonzero értéket ad vissza, ha a tábla nyitva van.
CDaoTableDef::Megnyitás Megnyitja az adatbázis TableDef gyűjteményében tárolt meglévő táblát.
CDaoTableDef::RefreshLink Frissíti a csatolt táblák kapcsolati adatait.
CDaoTableDef::SetAttributes Egy objektum egy vagy több jellemzőjét CDaoTableDef jelző értéket állít be.
CDaoTableDef::SetConnect Beállít egy értéket, amely információt nyújt a tábla forrásáról.
CDaoTableDef::SetName Beállítja a tábla nevét.
CDaoTableDef::SetSourceTableName Beállít egy értéket, amely megadja egy csatolt tábla nevét a forrásadatbázisban.
CDaoTableDef::SetValidationRule Beállít egy értéket, amely ellenőrzi egy mező adatait, miközben azokat módosítják vagy hozzáadják egy táblához.
CDaoTableDef::SetValidationText Beállít egy értéket, amely megadja az alkalmazás által megjelenített üzenet szövegét, ha egy Mező objektum értéke nem felel meg a megadott érvényességi szabálynak.

Nyilvános adatok tagjai

Név Description
CDaoTableDef::m_pDAOTableDef A tabledef objektum alapjául szolgáló DAO-felületre mutató mutató.
CDaoTableDef::m_pDatabase A tábla forrásadatbázisa.

Megjegyzések

Minden DAO-adatbázis-objektum egy TableDefs nevű gyűjteményt tart fenn, amely az összes mentett DAO tabledef objektumot tartalmazza.

Egy tábladefiníciót objektummal CDaoTableDef módosíthat. Például megteheted a következőket:

  • Vizsgálja meg az adatbázis bármely helyi, csatolt vagy külső táblájának mező- és indexstruktúráját.

  • Hívja meg a SetConnect csatolt táblák és SetSourceTableName tagfüggvényeket, és a RefreshLink tagfüggvény használatával frissítse a csatolt táblák kapcsolatait.

  • Hívja meg a CanUpdate tagfüggvényt annak megállapításához, hogy szerkesztheti-e a meződefiníciókat a táblában.

  • Kérje le vagy állítsa be az érvényesítési feltételeket az GetValidationRule és SetValidationRule, és a GetValidationTextSetValidationText tagfüggvények használatával.

  • Open A tagfüggvény használatával tábla-, dinakészlet- vagy pillanatkép típusú CDaoRecordset objektumot hozhat létre.

    Megjegyzés:

    A DAO-adatbázisosztályok különböznek az MFC-adatbázisosztályoktól az Open Database Connectivity (ODBC) alapján. Minden DAO-adatbázisosztály neve rendelkezik a "CDao" előtaggal. Továbbra is elérheti az ODBC-adatforrásokat a DAO-osztályokkal; A DAO-osztályok általában kiváló képességeket kínálnak, mivel a Microsoft Jet adatbázismotorra jellemzőek.

Táblaobjektumok használata meglévő táblával való munkavégzéshez vagy új tábla létrehozásához

  1. Minden esetben először hozzon létre egy CDaoTableDef objektumot, és adjon meg egy mutatót egy CDaoDatabase objektumnak, amelyhez a tábla tartozik.

  2. Ezután tegye a következőket a kívánttól függően:

    • Meglévő mentett tábla használatához hívja meg a tabledef objektum Open member függvényét, és adja meg a mentett tábla nevét.

    • Új tábla létrehozásához hívja meg a tabledef objektum Tag létrehozása függvényét, és adja meg a tábla nevét. A CreateField és a CreateIndex meghívásával mezőket és indexeket adhat hozzá a táblához.

    • Hívja meg a Hozzáfűzés parancsot a tábla mentéséhez az adatbázis TableDefs gyűjteményéhez fűzve. Create nyitott állapotba helyezi a tabledefet, így a hívás Create után nem kell meghívni Open.

      Jótanács

      A mentett táblák létrehozásának legegyszerűbb módja a táblák létrehozása és tárolása az adatbázisban a Microsoft Access használatával. Ezután megnyithatja és használhatja őket az MFC-kódban.

A megnyitott vagy létrehozott tabledef objektum használatához hozzon létre és nyisson meg egy CDaoRecordset objektumot, és adja meg a táblanév nevét az dbOpenTablenOpenType paraméterben.

Ha táblázatkezelő objektumot szeretne használni egy CDaoRecordset objektum létrehozásához, általában a fent leírt módon hoz létre vagy nyit meg egy táblázatot, majd létrehoz egy rekordhalmaz-objektumot, és a CDaoRecordset::Open hívásakor mutatót ad át a tabledef objektumnak. A megadott táblázatnak nyitott állapotban kell lennie. További információ: CDaoRecordset osztály.

Amikor befejezi a tábladefiniálási objektum használatát, hívja meg annak Tagság bezárása függvényét; majd megsemmisíti a tabledef objektumot.

Öröklési hierarchia

CObject

CDaoTableDef

Requirements

Fejléc:afxdao.h

CDaoTableDef::Append

Hívja meg ezt a tagfüggvényt, miután meghívta a Létrehozás parancsot, hogy hozzon létre egy új tábladef objektumot a táblafájl adatbázisba való mentéséhez.

virtual void Append();

Megjegyzések

A függvény hozzáfűzi az objektumot az adatbázis TableDefs gyűjteményéhez. A tabledef objektumot ideiglenes objektumként is használhatja, miközben definiálja úgy, hogy nem fűzi hozzá, de ha menteni és használni szeretné, akkor fel kell hívnia Append.

Megjegyzés:

Ha megkísérli hozzáfűzni egy névtelen tábladefet (null vagy üres sztringet tartalmazó), az MFC kivételt jelez.

A kapcsolódó információkért tekintse meg a DAO súgójának "Append Method" (Hozzáfűzési módszer) című témakörét.

CDaoTableDef::CanUpdate

Hívja meg ezt a tagfüggvényt annak meghatározásához, hogy az objektum alapjául szolgáló CDaoTableDef tábla definíciója módosítható-e.

BOOL CanUpdate();

Visszaadott érték

Nem kötelező, ha a táblaszerkezet (séma) módosítható (mezők és indexek hozzáadása vagy törlése), egyébként 0.

Megjegyzések

Alapértelmezés szerint egy objektum alapjául szolgáló CDaoTableDef újonnan létrehozott tábla frissíthető, és az objektum alapjául szolgáló CDaoTableDef csatolt tábla nem frissíthető. Egy CDaoTableDef objektum akkor is frissíthető, ha az eredményként kapott rekordhalmaz nem frissíthető.

A kapcsolódó információkért tekintse meg a DAO súgójának "Frissíthető tulajdonság" című témakörét.

CDaoTableDef::CDaoTableDef

Egy CDaoTableDef objektumot hoz létre.

CDaoTableDef(CDaoDatabase* pDatabase);

Paraméterek

pDatabase
Egy CDaoDatabase-objektumra mutató mutató.

Megjegyzések

Az objektum létrehozása után meg kell hívnia a Tag létrehozása vagy megnyitása függvényt. Amikor befejezi az objektumot, meg kell hívnia annak Bezárás tagfüggvényét, és el kell pusztítania az CDaoTableDef objektumot.

CDaoTableDef::Close

Ennek a tagfüggvénynek a meghívásával zárja be és engedje fel a tabledef objektumot.

virtual void Close();

Megjegyzések

Általában a hívás Closeután törli a tabledef objektumot, ha az a következővel newlett lefoglalva:

A hívás után ismét meghívhatja a Megnyitás parancsot Close. Így újra felhasználhatja a tabledef objektumot.

A kapcsolódó információkért tekintse meg a DAO súgójának "Metódus bezárása" című témakörét.

CDaoTableDef::Létrehozás

Új mentett tábla létrehozásához hívja meg ezt a tagfüggvényt.

virtual void Create(
    LPCTSTR lpszName,
    long lAttributes = 0,
    LPCTSTR lpszSrcTable = NULL,
    LPCTSTR lpszConnect = NULL);

Paraméterek

lpszName
A tábla nevét tartalmazó sztringre mutató mutató.

lAttributes
A tabledef objektum által képviselt tábla jellemzőinek megfelelő érték. A bitenkénti VAGY használatával a következő állandók bármelyikét kombinálhatja:

Állandó Description
dbAttachExclusive A Microsoft Jet adatbázismotort használó adatbázisok esetében azt jelzi, hogy a tábla egy kizárólagos használatra megnyitott csatolt tábla.
dbAttachSavePWD A Microsoft Jet adatbázismotort használó adatbázisok esetében a rendszer a csatolt tábla felhasználói azonosítóját és jelszavát menti a kapcsolati adatokkal.
dbSystemObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rendszertábla.
dbHiddenObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rejtett tábla.

lpszSrcTable
A forrástábla nevét tartalmazó sztringre mutató mutató. Alapértelmezés szerint ez az érték NULL értékként van inicializálva.

lpszConnect
Az alapértelmezett kapcsolati sztringet tartalmazó karakterláncra mutató mutató. Alapértelmezés szerint ez az érték NULL értékként van inicializálva.

Megjegyzések

Miután elnevezte a táblázatot, meghívhatja az Appendet , hogy mentse a táblázatot az adatbázis TableDefs gyűjteményében. A hívás Appendután a tábla nyitott állapotban van, és használhatja CDaoRecordset-objektum létrehozásához.

A kapcsolódó információkért tekintse meg a DAO súgójának "CreateTableDef metódus" című témakörét.

CDaoTableDef::CreateField

A tagfüggvény meghívásával adjon hozzá egy mezőt a táblához.

void CreateField(
    LPCTSTR lpszName,
    short nType,
    long lSize,
    long lAttributes = 0);

void CreateField(CDaoFieldInfo& fieldinfo);

Paraméterek

lpszName
Mutató egy sztringkifejezésre, amely a mező nevét adja meg.

nType
A mező adattípusát jelző érték. A beállítás az alábbi értékek egyike lehet:

Típus Méret (bájt) Description
dbBoolean 1 bájt BOOL
dbByte BÁJT
dbInteger 2 int
dbLong 4 hosszú
dbCurrency 8 Pénznem ( COleCurrency)
dbSingle 4 float
dbDouble 8 dupla
dbDate 8 Dátum/idő ( COleDateTime)
dbText 1 - 255 Szöveg ( CString)
dbLongBinary 0 Hosszú bináris (OLE objektum), CLongBinary vagy CByteArray
dbMemo 0 Feljegyzés ( CString)

lSize
Olyan érték, amely egy szöveget tartalmazó mező maximális méretét jelzi bájtban, vagy a szöveget vagy numerikus értékeket tartalmazó mező rögzített méretét. Az lSize paraméter figyelmen kívül lesz hagyva a szövegmezőkön kívül.

lAttributes
A mező jellemzőinek megfelelő érték, amely bitenkénti VAGY használatával kombinálható.

Állandó Description
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 Index objektum Mezőgyűjteményében lévő Mező objektumra vonatkozik). Ha kihagyja ezt az állandót, a mező növekvő (A – Z vagy 0 – 100) sorrendben lesz rendezve (alapértelmezett).

fieldinfo
Hivatkozás egy CDaoFieldInfo-struktúrára .

Megjegyzések

A DAOField program létrehoz egy (OLE) objektumot, és hozzáfűzi az DAOTableDef (OLE) objektum Mezők gyűjteményéhez. 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. Az első verzió CreateField egyszerűbb, de ha finomabb vezérlést szeretne, használhatja CreateFielda második verziót, amely egy paramétert CDaoFieldInfo vesz igénybe.

Ha a paramétert használó verziót CreateField használja, gondosan be kell állítania a struktúra alábbi tagjaitCDaoFieldInfo:CDaoFieldInfo

  • m_strName

  • m_nType

  • m_lSize

  • m_lAttributes

  • m_bAllowZeroLength

A többi tagnak CDaoFieldInfo0, HAMIS vagy üres sztringre kell állítania a tagnak megfelelően, vagy előfordulhat.CDaoException

A kapcsolódó információkért tekintse meg a DAO súgójának "CreateField Metódus" című témakörét.

CDaoTableDef::CreateIndex

A függvény meghívása index hozzáadásához egy táblához.

void CreateIndex(CDaoIndexInfo& indexinfo);

Paraméterek

indexinfo
Hivatkozás egy CDaoIndexInfo-struktúrára .

Megjegyzések

Az indexek meghatározzák az adatbázistáblákból elért rekordok sorrendjét, valamint azt, hogy elfogadják-e az ismétlődő rekordokat. Az indexek emellett hatékony hozzáférést biztosítanak az adatokhoz.

Nem kell indexeket létrehoznia a táblákhoz, de nagy, nem indexelt táblákban egy adott rekord elérése vagy egy rekordhalmaz létrehozása hosszú időt vehet igénybe. Másrészt a túl sok index létrehozása lelassítja a frissítési, hozzáfűzési és törlési műveleteket, mivel az összes index automatikusan frissül. Vegye figyelembe ezeket a tényezőket, amikor eldönti, hogy mely indexeket hozza létre.

A struktúra következő tagjait CDaoIndexInfo kell beállítani:

  • m_strName Nevet kell megadni.

  • m_pFieldInfos A szerkezetek tömbje CDaoIndexFieldInfo felé kell mutatnia.

  • m_nFields Meg kell adnia a struktúrák tömbjében CDaoFieldInfo lévő mezők számát.

A rendszer figyelmen kívül hagyja a többi tagot, ha FALSE (HAMIS) értékre van állítva. Emellett a rendszer figyelmen kívül hagyja a m_lDistinctCount tagot az index létrehozásakor.

CDaoTableDef::D eleteField

Hívja meg ezt a tagfüggvényt, hogy eltávolítson egy mezőt, és elérhetetlenné tegye azt.

void DeleteField(LPCTSTR lpszName);
void DeleteField(int nIndex);

Paraméterek

lpszName
Egy meglévő mező nevét tartalmazó sztringkifejezésre mutató mutató.

nIndex
A tábla nulla alapú Mezők gyűjteményében lévő mező indexe az index szerinti kereséshez.

Megjegyzések

Ezt a tagfüggvényt egy olyan új objektumon használhatja, amely nem lett hozzáfűzve az adatbázishoz, vagy ha a CanUpdate nemzero értéket ad vissza.

A kapcsolódó információkért tekintse meg a DAO súgójának "Metódus törlése" című témakörét.

CDaoTableDef::D eleteIndex

A tagfüggvény meghívása egy index törléséhez egy mögöttes táblában.

void DeleteIndex(LPCTSTR lpszName);
void DeleteIndex(int nIndex);

Paraméterek

lpszName
Egy meglévő index neveként megadott sztringkifejezésre mutató mutató.

nIndex
Az indexobjektum tömbindexe az adatbázis nullaalapú TableDefs gyűjteményében, az index szerinti kereséshez.

Megjegyzések

Ezt a tagfüggvényt egy olyan új objektumon használhatja, amely nem lett hozzáfűzve az adatbázishoz, vagy amikor a CanUpdate nemzero értéket ad vissza.

A kapcsolódó információkért tekintse meg a DAO súgójának "Metódus törlése" című témakörét.

CDaoTableDef::GetAttributes

Objektum CDaoTableDef esetén a visszatérési érték az objektum által CDaoTableDef képviselt tábla jellemzőit határozza meg, és az alábbi állandók összege lehet:

long GetAttributes();

Visszaadott érték

Egy objektum egy vagy több jellemzőjét CDaoTableDef jelző értéket ad vissza.

Megjegyzések

Állandó Description
dbAttachExclusive A Microsoft Jet adatbázismotort használó adatbázisok esetében azt jelzi, hogy a tábla egy kizárólagos használatra megnyitott csatolt tábla.
dbAttachSavePWD A Microsoft Jet adatbázismotort használó adatbázisok esetében a rendszer a csatolt tábla felhasználói azonosítóját és jelszavát menti a kapcsolati adatokkal.
dbSystemObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rendszertábla.
dbHiddenObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rejtett tábla.
dbAttachedTable Azt jelzi, hogy a tábla egy csatolt tábla egy nem ODBC-adatbázisból, például egy Paradox-adatbázisból.
dbAttachedODBC Azt jelzi, hogy a tábla egy ODBC-adatbázis csatolt táblája, például a Microsoft SQL Server.

A rendszertáblák a Microsoft Jet adatbázismotor által létrehozott táblák, amelyek különböző belső információkat tartalmaznak.

A rejtett táblázat a Microsoft Jet adatbázismotor által ideiglenes használatra létrehozott tábla.

A kapcsolódó információkért tekintse meg a DAO súgójának "Attribútumok tulajdonsága" című témakörét.

CDaoTableDef::GetConnect

Hívja meg ezt a tagfüggvényt egy adatforrás kapcsolati sztringjének lekéréséhez.

CString GetConnect();

Visszaadott érték

A CString tábla elérési útját és adatbázistípusát tartalmazó objektum.

Megjegyzések

Egy CDaoTableDef csatolt táblát képviselő objektum esetében az CString objektum egy vagy két részből áll (egy adatbázistípus-meghatározóból és egy adatbázis elérési útból).

Az alábbi táblázatban látható elérési út az adatbázisfájlokat tartalmazó könyvtár teljes elérési útja, amelyet a "DATABASE=" azonosítónak kell megelőznie. Bizonyos esetekben (a Microsoft Jethez és a Microsoft Excel-adatbázisokhoz hasonlóan) egy adott fájlnév szerepel az adatbázis elérési útjának argumentumában.

A CDaoTableDef::SetConnect táblája megjeleníti a lehetséges adatbázistípusokat és azok megfelelő adatbázis-azonosítóit és elérési útvonalait:

A Microsoft Jet adatbázis-alaptáblái esetében a kijelölő egy üres sztring ("").

Ha jelszóra van szükség, de nincs megadva, az ODBC-illesztő megjeleníti a bejelentkezési párbeszédpanelt a táblák első elérésekor, majd újra, ha a kapcsolat bezárul és újra megnyílik. Ha egy csatolt tábla rendelkezik az dbAttachSavePWD attribútummal, a bejelentkezési kérés nem jelenik meg a tábla újbóli megnyitásakor.

A kapcsolódó információkért tekintse meg a "Tulajdonság csatlakoztatása" című témakört a DAO súgójában.

CDaoTableDef::GetDateCreated

Hívja meg ezt a függvényt az objektum alapjául szolgáló tábla létrehozásának dátumának és időpontjának CDaoTableDef meghatározásához.

COleDateTime GetDateCreated();

Visszaadott érték

Az objektum alapjául szolgáló CDaoTableDef tábla létrehozásának dátumát és időpontját tartalmazó érték.

Megjegyzések

A dátum- és időbeállítások attól a számítógéptől származnak, amelyen az alaptáblát létrehozták vagy legutóbb frissítették. Többfelhasználós környezetben a felhasználóknak ezeket a beállításokat közvetlenül a fájlkiszolgálóról kell beszerezni az eltérések elkerülése érdekében; vagyis minden ügyfélnek "standard" időforrást kell használnia – talán egy kiszolgálóról.

A kapcsolódó információkért tekintse meg a DAO súgójának "DateCreated, LastUpdated Properties" (DateCreated, LastUpdated Properties) című témakörét.

CDaoTableDef::GetDateLastUpdated

Hívja meg ezt a függvényt az objektum alapjául szolgáló CDaoTableDef tábla legutóbbi frissítésének dátumának és időpontjának meghatározásához.

COleDateTime GetDateLastUpdated();

Visszaadott érték

Az objektum alapjául szolgáló CDaoTableDef tábla utolsó frissítésének dátumát és időpontját tartalmazó érték.

Megjegyzések

A dátum- és időbeállítások attól a számítógéptől származnak, amelyen az alaptáblát létrehozták vagy legutóbb frissítették. Többfelhasználós környezetben a felhasználóknak ezeket a beállításokat közvetlenül a fájlkiszolgálóról kell beszerezni az eltérések elkerülése érdekében; vagyis minden ügyfélnek "standard" időforrást kell használnia – talán egy kiszolgálóról.

A kapcsolódó információkért tekintse meg a DAO súgójának "DateCreated, LastUpdated Properties" (DateCreated, LastUpdated Properties) című témakörét.

CDaoTableDef::GetFieldCount

Hívja meg ezt a tagfüggvényt a táblában definiált mezők számának lekéréséhez.

short GetFieldCount();

Visszaadott érték

A tábla mezőinek száma.

Megjegyzések

Ha értéke 0, akkor nincsenek objektumok a gyűjteményben.

A kapcsolódó információkért tekintse meg a DAO súgójának "Count Property" (Count Property) című témakörét.

CDaoTableDef::GetFieldInfo

Ennek a tagfüggvénynek a meghívásával különböző típusú információkat szerezhet be a táblafoglalatban meghatározott mezőről.

void GetFieldInfo(
    int nIndex,
    CDaoFieldInfo& fieldinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetFieldInfo(
    LPCTSTR lpszName,
    CDaoFieldInfo& fieldinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

Paraméterek

nIndex
A tábla nulla alapú Mezők gyűjteményében lévő mezőobjektum indexe, amely az index szerinti kereséshez használható.

fieldinfo
Hivatkozás egy CDaoFieldInfo-struktúrára .

dwInfoOptions
A beolvasandó mezőre vonatkozó információkat meghatározó beállítások. A rendelkezésre álló lehetőségeket itt találja, valamint azt is, hogy mi okozza a függvény visszatérését:

  • AFX_DAO_PRIMARY_INFO (Alapértelmezett) Név, típus, méret, attribútumok. Használja ezt a lehetőséget a leggyorsabb teljesítmény érdekében.

  • AFX_DAO_SECONDARY_INFO Elsődleges információk, plusz: Sorszám, Kötelező, Nulla hossz engedélyezése, Rendezési sorrend, Idegen név, Forrásmező, Forrástábla

  • AFX_DAO_ALL_INFO Elsődleges és másodlagos információk, valamint: Érvényesítési szabály, Érvényesítési szöveg, Alapértelmezett érték

lpszName
A mezőobjektum nevére mutató mutató a név szerinti kereséshez. A név legfeljebb 64 karakter hosszúságú sztring, amely egyedileg nevezi el a mezőt.

Megjegyzések

A függvény egyik verziója lehetővé teszi egy mező index szerinti keresését. A másik verzió lehetővé teszi a mező név szerinti keresését.

A visszaadott információk leírását a CDaoFieldInfo struktúrában talál. Ez a struktúra olyan tagokkal rendelkezik, amelyek megfelelnek a dwInfoOptions leírásában felsorolt információknak. Ha egy szinten kér információt, minden korábbi szintről is kap információt.

A kapcsolódó információkért tekintse meg a DAO súgójának "Attribútumok tulajdonsága" című témakörét.

CDaoTableDef::GetIndexCount

Hívja meg ezt a tagfüggvényt egy tábla indexeinek számának lekéréséhez.

short GetIndexCount();

Visszaadott érték

A tábla indexeinek száma.

Megjegyzések

Ha értéke 0, akkor a gyűjteményben nincsenek indexek.

A kapcsolódó információkért tekintse meg a DAO súgójának "Count Property" (Count Property) című témakörét.

CDaoTableDef::GetIndexInfo

Hívja meg ezt a tagfüggvényt, hogy különböző típusú információkat szerezzen be a táblában definiált indexről.

void GetIndexInfo(
    int nIndex,
    CDaoIndexInfo& indexinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetIndexInfo(
    LPCTSTR lpszName,
    CDaoIndexInfo& indexinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

Paraméterek

nIndex
A tábla nullaalapú Indexek gyűjteményében található Index objektum numerikus indexe, amely a gyűjteményben elfoglalt helye alapján keres.

indexinfo
Hivatkozás egy CDaoIndexInfo-struktúrára .

dwInfoOptions
Az index beolvasandó információinak megadására szolgáló beállítások. A rendelkezésre álló lehetőségeket itt találja, valamint azt is, hogy mi okozza a függvény visszatérését:

  • AFX_DAO_PRIMARY_INFO Név, mezőadatok, mezők. Használja ezt a lehetőséget a leggyorsabb teljesítmény érdekében.

  • AFX_DAO_SECONDARY_INFO Elsődleges információ, plusz: Elsődleges, Egyedi, Fürtözött, Null értékek figyelmen kívül hagyása, Kötelező, Idegen

  • AFX_DAO_ALL_INFO Elsődleges és másodlagos információk, valamint: Eltérő darabszám

lpszName
Az indexobjektum nevére mutató mutató a név szerinti kereséshez.

Megjegyzések

A függvény egyik verziója lehetővé teszi, hogy megkeressen egy indexet a gyűjteményben elfoglalt helye alapján. A másik verzió lehetővé teszi az index név szerinti keresését.

A visszaadott információk leírását a CDaoIndexInfo struktúrában talál. Ez a struktúra olyan tagokkal rendelkezik, amelyek megfelelnek a dwInfoOptions leírásában felsorolt információknak. Ha egy szinten kér információt, minden korábbi szintről is kap információt.

A kapcsolódó információkért tekintse meg a DAO súgójának "Attribútumok tulajdonsága" című témakörét.

CDaoTableDef::GetName

Hívja meg ezt a tagfüggvényt a mögöttes tábla felhasználó által definiált nevének lekéréséhez.

CString GetName();

Visszaadott érték

Egy tábla felhasználó által definiált neve.

Megjegyzések

Ez a név betűvel kezdődik, és legfeljebb 64 karaktert tartalmazhat. Tartalmazhat számokat és aláhúzásjeleket, de nem tartalmazhat írásjeleket vagy szóközöket.

A kapcsolódó információkért tekintse meg a DAO súgójának "Névtulajdonság" című témakörét.

CDaoTableDef::GetRecordCount

Hívja meg ezt a tagfüggvényt, hogy megtudja, hány rekord található egy CDaoTableDef objektumban.

long GetRecordCount();

Visszaadott érték

A tabledef objektumban elért rekordok száma.

Megjegyzések

A tábla típusú CDaoTableDef objektumok meghívása GetRecordCount a tábla rekordjainak hozzávetőleges számát tükrözi, és a táblarekordok hozzáadása és törlése azonnal hatással van gombra. A visszaállított tranzakciók a rekordszám részeként jelennek meg, amíg meg nem hívja a CDaoWorkSpace::CompactDatabase függvényt. A CDaoTableDef rekordokat nem tartalmazó objektumok rekordszám tulajdonsága 0. Csatolt táblák vagy ODBC-adatbázisok GetRecordCount használatakor mindig -1 értéket ad vissza.

A kapcsolódó információkért tekintse meg a DAO súgójának "RecordCount tulajdonsága" című témakörét.

CDaoTableDef::GetSourceTableName

Hívja meg ezt a tagfüggvényt egy csatolt tábla nevének lekéréséhez egy forrásadatbázisban.

CString GetSourceTableName();

Visszaadott érték

Egy CString csatolt tábla forrásnevét megadó objektum, natív adattábla esetén üres sztring.

Megjegyzések

A csatolt tábla egy másik, Microsoft Jet-adatbázishoz csatolt adatbázis táblája. A csatolt táblák adatai a külső adatbázisban maradnak, ahol más alkalmazások is kezelhetik azokat.

A kapcsolódó információkért tekintse meg a DAO súgójának "SourceTableName tulajdonság" című témakörét.

CDaoTableDef::GetValidationRule

Hívja meg ezt a tagfüggvényt egy tábla érvényességi szabályának lekéréséhez.

CString GetValidationRule();

Visszaadott érték

Olyan CString objektum, amely ellenőrzi egy mező adatait, amikor azokat módosítják vagy hozzáadják egy táblához.

Megjegyzések

A frissítési műveletekhez érvényesítési szabályok használhatók. Ha a tábla egy érvényesítési szabályt tartalmaz, az adott tábla frissítéseinek meg kell egyeznie az előre meghatározott feltételeknek az adatok módosítása előtt. Ha a módosítás nem felel meg a feltételeknek, a rendszer kivételt hoz létre, amely a GetValidationText értékét tartalmazza. Egy CDaoTableDef objektum esetében ez CString írásvédett egy csatolt táblához, és egy alaptábla írási/olvasási/írási funkciója.

A kapcsolódó információkért tekintse meg a DAO súgójának "ValidationRule tulajdonsága" című témakörét.

CDaoTableDef::GetValidationText

Hívja meg ezt a függvényt, hogy lekérje a sztringet, hogy megjelenjen, amikor egy felhasználó olyan adatokat ír be, amelyek nem felelnek meg az érvényesítési szabálynak.

CString GetValidationText();

Visszaadott érték

Olyan CString objektum, amely megadja a megjelenített szöveget, ha a felhasználó olyan adatokat ad meg, amelyek nem felelnek meg az érvényesítési szabálynak.

Megjegyzések

Egy CDaoTableDef objektum esetében ez CString írásvédett egy csatolt táblához, és egy alaptábla írási/olvasási/írási funkciója.

A kapcsolódó információkért tekintse meg a DAO súgójának "ValidationText Tulajdonság" című témakörét.

CDaoTableDef::IsOpen

Hívja meg ezt a tagfüggvényt annak megállapításához, hogy az CDaoTableDef objektum jelenleg nyitva van-e.

BOOL IsOpen() const;

Visszaadott érték

Nonzero, ha az CDaoTableDef objektum nyitva van, ellenkező esetben 0.

Megjegyzések

CDaoTableDef::m_pDatabase

A tábla CDaoDatabase objektumára mutató mutatót tartalmaz.

Megjegyzések

CDaoTableDef::m_pDAOTableDef

Az objektum alapjául szolgáló DAO tabledef objektum OLE felületére CDaoTableDef mutató mutatót tartalmaz.

Megjegyzések

Ezt a mutatót akkor használja, ha közvetlenül hozzá kell férnie a DAO-felülethez.

CDaoTableDef::Megnyitás

Hívja meg ezt a tagfüggvényt az adatbázis TableDef gyűjteményében korábban mentett táblázat megnyitásához.

virtual void Open(LPCTSTR lpszName);

Paraméterek

lpszName
Egy táblanevet meghatározó sztringre mutató mutató.

Megjegyzések

Hívja meg ezt a tagfüggvényt egy csatolt tábla kapcsolati adatainak frissítéséhez.

void RefreshLink();

Megjegyzések

A csatolt táblák kapcsolati adatait úgy módosíthatja, hogy meghívja a SetConnectet a megfelelő CDaoTableDef objektumon, majd a RefreshLink tagfüggvény használatával frissíti az információkat. Híváskor RefreshLinka csatolt tábla tulajdonságai nem változnak.

A módosított kapcsolódási információk érvénybe léptetéséhez az ezen a táblázaton alapuló összes megnyitott CDaoRecordset objektumot be kell zárni.

A kapcsolódó információkért tekintse meg a "RefreshLink Metódus" témakört a DAO súgójában.

CDaoTableDef::SetAttributes

Egy objektum egy vagy több jellemzőjét CDaoTableDef jelző értéket állít be.

void SetAttributes(long lAttributes);

Paraméterek

lAttributes
Az objektum által CDaoTableDef képviselt tábla jellemzői és az alábbi állandók összege lehet:

Állandó Description
dbAttachExclusive A Microsoft Jet adatbázismotort használó adatbázisok esetében azt jelzi, hogy a tábla egy kizárólagos használatra megnyitott csatolt tábla.
dbAttachSavePWD A Microsoft Jet adatbázismotort használó adatbázisok esetében a rendszer a csatolt tábla felhasználói azonosítóját és jelszavát menti a kapcsolati adatokkal.
dbSystemObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rendszertábla.
dbHiddenObject Azt jelzi, hogy a tábla a Microsoft Jet adatbázismotor által biztosított rejtett tábla.

Megjegyzések

Több attribútum beállításakor kombinálhatja őket a megfelelő állandók összeadásával a bitenkénti VAGY operátorral. A nem gyorsítótárazott táblák beállítása dbAttachExclusive kivételt eredményez. A következő értékek kombinálása kivételt is eredményez:

  • dbAttachExclusive | dbAttachedODBC

  • dbAttachSavePWD | dbAttachedTable

A kapcsolódó információkért tekintse meg a DAO súgójának "Attribútumok tulajdonsága" című témakörét.

CDaoTableDef::SetConnect

Egy CDaoTableDef csatolt táblát képviselő objektum esetében a sztringobjektum egy vagy két részből áll (egy adatbázistípus-meghatározóból és egy adatbázis elérési útból).

void SetConnect(LPCTSTR lpszConnect);

Paraméterek

lpszConnect
Egy sztringkifejezésre mutató mutató, amely további paramétereket ad át az ODBC-nek vagy a telepíthető ISAM-illesztőprogramoknak.

Megjegyzések

Az alábbi táblázatban látható elérési út az adatbázisfájlokat tartalmazó könyvtár teljes elérési útja, amelyet a "DATABASE=" azonosítónak kell megelőznie. Bizonyos esetekben (a Microsoft Jethez és a Microsoft Excel-adatbázisokhoz hasonlóan) egy adott fájlnév szerepel az adatbázis elérési útjának argumentumában.

Megjegyzés:

Ne foglaljon szóközt a "DATABASE=drive:\\path" űrlap egyenlő bejelentkezési útvonal-utasításai köré. Ez kivételt eredményez, és a kapcsolat meghiúsul.

Az alábbi táblázat a lehetséges adatbázistípusokat és azok megfelelő adatbázis-azonosítóit és elérési útvonalait mutatja be:

Adatbázis típusa Kijelölő Útvonal
Adatbázis a Jet adatbázismotorral "[ database];" " drive:\\ elérési út\\ fájlneve. MDB"
dBASE III "dBASE III;" " drive:\\ path"
dBASE IV "dBASE IV;" " drive:\\ path"
dBASE 5 "dBASE 5.0;" " drive:\\ path"
Paradoxon 3.x "Paradox 3.x;" " drive:\\ path"
Paradox 4.x "Paradox 4.x;" " drive:\\ path"
Paradox 5.x "Paradox 5.x;" " drive:\\ path"
Excel 3.0 "Excel 3.0;" " drive:\\ elérési út\\ fájlneve.XLS"
Excel 4.0 "Excel 4.0;" " drive:\\ elérési út\\ fájlneve.XLS"
Excel 5.0 vagy Excel 95 "Excel 5.0;" " drive:\\ elérési út\\ fájlneve.XLS"
Excel 97 "Excel 8.0;" " drive:\\ elérési út\ fájlneve.XLS"
HTML-importálás "HTML-importálás;" " drive:\\ path\ filename"
HTML-exportálás "HTML-exportálás;" " drive:\\ path"
Szöveg "Szöveg;" "meghajtó:\\path"
ODBC "ODBC; DATABASE= database; UID= felhasználó; PWD= jelszó; DSN = adatforrásnév; LOGINTIMEOUT= másodperc;" (Lehet, hogy ez nem minden kiszolgáló teljes kapcsolati sztringje, csak egy példa. Nagyon fontos, hogy ne legyen szóköz a paraméterek között.) Nincs
Tőzsde "Exchange;

MAPILEVEL= folderpath;

[TABLETYPE={ 0 | 1 };]

[PROFILE= profile;]

[PWD= jelszó;]

[DATABASE= database;]"		 "meghajtó:\\ elérési út\\ fájlneve. MDB"

Megjegyzés:

A Btrieve már nem támogatott a DAO 3.5-ös verziójától.

A kapcsolati sztringekben kettős fordított perjelet (\\) kell használnia. Ha módosította egy meglévő kapcsolat tulajdonságait a használatával SetConnect, ezt követően meg kell hívnia a RefreshLinket. Ha a kapcsolat tulajdonságait SetConnectinicializálja, nem kell meghívnia RefreshLink, de ha ezt választja, először fűzze hozzá a táblázatot.

Ha jelszóra van szükség, de nincs megadva, az ODBC-illesztő megjeleníti a bejelentkezési párbeszédpanelt a táblák első elérésekor, majd újra, ha a kapcsolat bezárul és újra megnyílik.

Egy objektum kapcsolati sztringjének CDaoTableDef beállításához adjon meg egy forrásargumentumot a Create tagfüggvénynek. A beállítással meghatározhatja az adatbázis típusát, elérési útját, felhasználói azonosítóját, jelszavát vagy ODBC-adatforrását. További információkért tekintse meg az adott illesztőprogram dokumentációját.

A kapcsolódó információkért tekintse meg a "Tulajdonság csatlakoztatása" című témakört a DAO súgójában.

CDaoTableDef::SetName

Hívja meg ezt a tagfüggvényt egy tábla felhasználó által definiált nevének beállításához.

void SetName(LPCTSTR lpszName);

Paraméterek

lpszName
Egy tábla nevét meghatározó sztringkifejezésre mutató mutató.

Megjegyzések

A névnek betűvel kell kezdődnie, és legfeljebb 64 karaktert tartalmazhat. Tartalmazhat számokat és aláhúzásjeleket, de nem tartalmazhat írásjeleket vagy szóközöket.

A kapcsolódó információkért tekintse meg a DAO súgójának "Névtulajdonság" című témakörét.

CDaoTableDef::SetSourceTableName

Ennek a tagfüggvénynek a meghívásával adja meg egy csatolt tábla nevét vagy annak az alaptáblának a nevét, amelyen az CDaoTableDef objektum alapul, mivel az az adatok eredeti forrásában található.

void SetSourceTableName(LPCTSTR lpszSrcTableName);

Paraméterek

lpszSrcTableName
Mutató egy sztringkifejezésre, amely egy táblanevet ad meg a külső adatbázisban. Alaptábla esetén a beállítás egy üres sztring ("").

Megjegyzések

Ezután meg kell hívnia a RefreshLinket. Ez a tulajdonságbeállítás üres egy alaptáblához, és olvasási/írási lehetőséget biztosít egy csatolt táblához vagy egy olyan objektumhoz, amely nincs hozzáfűzve egy gyűjteményhez.

A kapcsolódó információkért tekintse meg a DAO súgójának "SourceTableName tulajdonság" című témakörét.

CDaoTableDef::SetValidationRule

Hívja meg ezt a tagfüggvényt egy tábla érvényességi szabályának beállításához.

void SetValidationRule(LPCTSTR lpszValidationRule);

Paraméterek

lpszValidationRule
Egy műveletet érvényesítő sztringkifejezésre mutató mutató.

Megjegyzések

A frissítési műveletekhez érvényesítési szabályok használhatók. Ha a tábla egy érvényesítési szabályt tartalmaz, az adott tábla frissítéseinek meg kell egyeznie az előre meghatározott feltételeknek az adatok módosítása előtt. Ha a módosítás nem felel meg a feltételeknek, megjelenik egy, a GetValidationText szöveget tartalmazó kivétel.

Az érvényesítés csak a Microsoft Jet adatbázismotort használó adatbázisok esetében támogatott. A kifejezés nem hivatkozhat felhasználó által definiált függvényekre, tartomány-összesítő függvényekre, SQL-összesítő függvényekre vagy lekérdezésekre. Egy objektum érvényességi szabálya CDaoTableDef az objektum több mezőjére is hivatkozhat.

Az hire_date és termination_date nevű mezők esetében például az érvényesítési szabály a következő lehet:

myTableDef.SetValidationRule(_T("termination_date > hire_date"));

A kapcsolódó információkért tekintse meg a DAO súgójának "ValidationRule tulajdonsága" című témakörét.

CDaoTableDef::SetValidationText

Hívja meg ezt a tagfüggvényt egy, a Microsoft Jet adatbázismotor által támogatott alaptáblával rendelkező objektum érvényességi szabályának CDaoTableDef kivételszövegének beállításához.

void SetValidationText(LPCTSTR lpszValidationText);

Paraméterek

lpszValidationText
Egy sztringkifejezésre mutató mutató, amely megadja, hogy a megadott adatok érvénytelenek-e.

Megjegyzések

Csatolt tábla érvényesítési szövegét nem állíthatja be.

A kapcsolódó információkért tekintse meg a DAO súgójának "ValidationText Tulajdonság" című témakörét.

Lásd még

CObject osztály
hierarchiadiagram
CDaoDatabase osztály
CDaoRecordset osztály

  • Last updated on