CDaoQueryDefInfo 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 CDaoQueryDefInfo struktúra adatokat tartalmaz az adatelérési objektumokhoz (DAO) definiált lekérdezésdef objektumról.

Megjegyzés:

Az Adatelérési objektum (DAO) az Office 2013-on keresztül támogatott. A DAO 3.6 a végleges verzió, és elavult.

Szemantika

struct CDaoQueryDefInfo
{
    CString m_strName;               // Primary
    short m_nType;   // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    BOOL m_bUpdatable;               // Secondary
    BOOL m_bReturnsRecords;          // Secondary
    CString m_strSQL;                // All
    CString m_strConnect;            // All
    short m_nODBCTimeout;            // All
};

Paraméterek

m_strName
Egyedileg nevezi el a querydef objektumot. További információ: "Névtulajdonság" a DAO súgójában. Hívja meg a CDaoQueryDef::GetName parancsot a tulajdonság közvetlen lekéréséhez.

m_nType
Egy lekérdezésdefiniálási objektum működési típusát jelző érték. Az érték a következő lehet:

• dbQSelect Kiválasztás: a lekérdezés kijelöli a rekordokat.

• dbQAction Művelet: a lekérdezés áthelyezi vagy módosítja az adatokat, de nem ad vissza rekordokat.

• dbQCrosstab Kereszttáblás: a lekérdezés számolótábla-szerű formátumban adja vissza az adatokat.

• dbQDelete Törlés: a lekérdezés törli a megadott sorok egy készletét.

• dbQUpdate Frissítés: a lekérdezés rekordokat módosít.

• dbQAppend Hozzáfűzés: a lekérdezés új rekordokat ad hozzá egy tábla vagy lekérdezés végéhez.

• dbQMakeTable Tábla készítése: a lekérdezés új táblát hoz létre egy rekordhalmazból.

• dbQDDL Adatdefiníció: a lekérdezés hatással van a táblák vagy azok részeinek szerkezetére.

• dbQSQLPassThrough Továbbítás: az SQL-utasítás közvetlenül az adatbázis háttérrendszerének lesz átadva köztes feldolgozás nélkül.

• dbQSetOperation Unió: a lekérdezés létrehoz egy pillanatkép típusú rekordhalmaz-objektumot, amely az összes megadott rekord adatait tartalmazza két vagy több táblában, az ismétlődő rekordokat eltávolítva. Az ismétlődések hozzáadásához adja hozzá az ALL kulcsszót a querydef SQL-utasításához.

• dbQSPTBulk dbQSQLPassThrough Olyan lekérdezés megadására szolgál, amely nem ad vissza rekordokat.

Megjegyzés:

SQL-átmenő lekérdezés létrehozásához nem állítja be az állandót dbQSQLPassThrough . Ezt a Microsoft Jet adatbázismotor automatikusan állítja be, amikor létrehoz egy lekérdezési objektumot, és beállítja a tulajdonságot Connect .

További információ: "Típustulajdonság" a DAO súgójában.

m_dateCreated
A lekérdezésdef létrehozásának dátuma és időpontja. A lekérdezésdef létrehozásának dátumának közvetlen lekéréséhez hívja meg a táblához társított objektum GetDateCreated tagfüggvényét CDaoTableDef . További információ: Megjegyzések. Tekintse meg a DAO súgójának "DateCreated, LastUpdated Properties" (DateCreated, LastUpdated Properties) című témakörét is.

m_dateLastUpdated
A lekérdezésdef legutóbbi módosításának dátuma és időpontja. A tábla utolsó frissítésének dátumának közvetlen lekéréséhez hívja meg a lekérdezésdef GetDateLastUpdated tagfüggvényét. További információ: Megjegyzések. Tekintse meg a DAO súgójának "DateCreated, LastUpdated Properties" (DateCreated, LastUpdated Properties) című témakörét is.

m_bUpdatable
Azt jelzi, hogy lehet-e módosításokat végrehajtani egy lekérdezésdefiniálási objektumon. Ha ez a tulajdonság IGAZ, a lekérdezési érték frissíthető; ellenkező esetben nem. Frissíthető: a lekérdezésdef objektum lekérdezésdefiníciója módosítható. A lekérdezésdef objektum Frissíthető tulajdonsága IGAZ értékre van állítva, ha a lekérdezésdefiníció frissíthető, még akkor is, ha az eredményül kapott rekordhalmaz nem frissíthető. A tulajdonság közvetlen lekéréséhez hívja meg a lekérdezésdef CanUpdate tagfüggvényét. További információ: "Frissíthető tulajdonság" a DAO súgójában.

m_bReturnsRecords
Azt jelzi, hogy egy SQL-továbbítási lekérdezés egy külső adatbázisba rekordokat ad-e vissza. Ha ez a tulajdonság IGAZ, a lekérdezés rekordokat ad vissza. A tulajdonság közvetlen lekéréséhez hívja meg a CDaoQueryDef::GetReturnsRecords parancsot. Nem minden SQL-továbbítási lekérdezés ad vissza rekordokat a külső adatbázisoknak. Egy SQL UPDATE-utasítás például rekordok visszaadása nélkül frissíti a rekordokat, míg az SQL SELECT utasítás rekordokat ad vissza. További információ: "ReturnsRecords tulajdonság" a DAO súgójában.

m_strSQL
A lekérdezésdef objektum által végrehajtott lekérdezést meghatározó SQL-utasítás. Az SQL-tulajdonság tartalmazza az SQL-utasítást, amely meghatározza a rekordok kiválasztásának, csoportosításának és sorrendjének módját a lekérdezés végrehajtásakor. A lekérdezéssel kiválaszthatja a dynaset- vagy pillanatkép típusú rekordhalmaz-objektumba felvenni kívánt rekordokat. Tömeges lekérdezéseket is definiálhat az adatok rekordok visszaadása nélküli módosításához. Ennek a tulajdonságnak az értékét közvetlenül lekérheti a lekérdezésdef GetSQL-tagfüggvényének meghívásával.

m_strConnect
Információt nyújt egy átmenő lekérdezésben használt adatbázis forrásáról. Ez az információ egy kapcsolati sztring formájában jelenik meg. A kapcsolati sztringekről és a tulajdonság értékének közvetlen lekéréséről a CDaoDatabase::GetConnect tagfüggvényben talál további információt.

m_nODBCTimeout
Azon másodpercek száma, amíg a Microsoft Jet adatbázismotor időtúllépési hiba előtt várakozik, amikor egy lekérdezés open database connectivity (ODBC) adatbázison fut. ODBC-adatbázis , például Microsoft SQL Server használata esetén késések léphetnek fel a hálózati forgalom vagy az ODBC-kiszolgáló nagy mértékű használata miatt. A határozatlan idejű várakozás helyett megadhatja, hogy a Microsoft Jet motor mennyi ideig várakozik, mielőtt hibát okoz. Az alapértelmezett időtúllépési érték 60 másodperc. Ennek a tulajdonságnak az értékét közvetlenül lekérheti a lekérdezésdef GetODBCTimeout tagfüggvényének meghívásával. További információ: "ODBCTimeout tulajdonság" a DAO súgójában.

Megjegyzések

A querydef a CDaoQueryDef osztály objektuma. Az Elsődleges, a Másodlagos és az Összes elemre mutató hivatkozások azt jelzik, hogy a GetQueryDefInfo tagfüggvény hogyan adja vissza az adatokat az osztályban CDaoDatabase.

A CDaoDatabase::GetQueryDefInfo tagfüggvény által lekért információk egy CDaoQueryDefInfo struktúrában tárolódnak. Annak az adatbázis-objektumnak a hívása GetQueryDefInfo , amelyben a QueryDefs gyűjtemény a querydef objektumot tárolja. CDaoQueryDefInfo emellett definiál egy tagfüggvényt Dump a hibakeresési buildekben. Az objektum tartalmának kiírására CDaoQueryDefInfo is használhatóDump. Az osztály CDaoDatabase tagfüggvényeket is biztosít az objektumban visszaadott összes tulajdonság közvetlen eléréséhez, ezért ritkán hívja meg a függvényt CDaoQueryDefInfoGetQueryDefInfo.

Amikor új mező- vagy paraméterobjektumot fűz egy lekérdezésdef objektum Mező vagy Paraméter gyűjteményéhez, kivételt kap, ha a mögöttes adatbázis nem támogatja az új objektumhoz megadott adattípust.

A dátum- és időbeállítások attól a számítógéptől származnak, amelyen a lekérdezést létrehozták vagy legutóbb frissítették. Többfelhasználós környezetben a felhasználóknak közvetlenül a fájlkiszolgálóról kell lekérni ezeket a beállításokat a Net Time paranccsal, hogy elkerüljék a DateCreated és a LastUpdated tulajdonságbeállítások eltéréseit.

Requirements

Fejléc:afxdao.h

Lásd még

Struktúrák, stílusok, visszahívások és üzenettérképek
CDaoQueryDef osztály
CDaoDatabase osztály