CDaoQueryDefInfo – struktura

Článek
08/13/2024

Struktura CDaoQueryDefInfo obsahuje informace o objektu querydef definovaném pro objekty přístupu k datům (DAO).

Poznámka:

Objekt pro přístup k datům (DAO) se podporuje prostřednictvím Office 2013. DAO 3.6 je konečná verze a je zastaralá.

Syntaxe

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

Parametry

m_strName
Jednoznačně pojmenuje objekt querydef. Další informace najdete v tématu "Vlastnost názvu" v nápovědě k dao. Volání CDaoQueryDef::GetName pro načtení této vlastnosti přímo.

m_nType
Hodnota, která označuje provozní typ objektu querydef. Hodnota může být jedna z těchto hodnot:

dbQSelect Výběr: Dotaz vybere záznamy.
dbQAction Akce: Dotaz přesune nebo změní data, ale nevrací záznamy.
dbQCrosstab Křížová tabulka: Dotaz vrátí data ve formátu podobném tabulce.
dbQDelete Odstranit: Dotaz odstraní sadu zadaných řádků.
dbQUpdate Aktualizace: Dotaz změní sadu záznamů.
dbQAppend Připojení: Dotaz přidá na konec tabulky nebo dotazu nové záznamy.
dbQMakeTable Make-table: Dotaz vytvoří novou tabulku ze sady záznamů.
dbQDDL Definice dat: Dotaz ovlivňuje strukturu tabulek nebo jejich částí.
dbQSQLPassThrough Předávání: Příkaz SQL se předává přímo do back-endu databáze bez přechodného zpracování.
dbQSetOperation Sjednocení: Dotaz vytvoří objekt sady záznamů typu snímku obsahující data ze všech zadaných záznamů ve dvou nebo více tabulkách s odebranými duplicitními záznamy. Chcete-li zahrnout duplicity, přidejte klíčové slovo ALL do příkazu SQL querydef.
dbQSPTBulkdbQSQLPassThrough Používá se k zadání dotazu, který nevrací záznamy.

Poznámka:

Pokud chcete vytvořit předávací dotaz SQL, nenastavíte konstantu dbQSQLPassThrough . Toto nastavení automaticky nastaví databázový stroj Microsoft Jet při vytváření objektu querydef a nastavení Connect vlastnosti.

Další informace najdete v tématu "Typ vlastnosti" v nápovědě k dao.

m_dateCreated
Datum a čas vytvoření dotazu. Pokud chcete přímo načíst datum vytvoření dotazu, zavolejte getDateCreated členské funkce objektu CDaoTableDef přidruženého k tabulce. Další informace naleznete v tématu Poznámky. Podívejte se také na téma "DateCreated, LastUpdated Properties" v nápovědě k DAO.

m_dateLastUpdated
Datum a čas poslední změny provedené v dotazu. Pokud chcete přímo načíst datum, kdy byla tabulka naposledy aktualizována, zavolejte funkci člena GetDateLastUpdated dotazu. Další informace naleznete v tématu Poznámky. Podívejte se také na téma "DateCreated, LastUpdated Properties" v nápovědě k DAO.

m_bUpdatable
Určuje, zda je možné provést změny v objektu querydef. Pokud je tato vlastnost TRUE, dotazovat lze aktualizovat; jinak to není. Aktualizovatelné znamená, že definici dotazu objektu querydef je možné změnit. Vlastnost Updatable objektu querydef je nastavena na HODNOTU TRUE, pokud lze aktualizovat definici dotazu, i když výsledná sada záznamů není aktualizovatelná. Pokud chcete tuto vlastnost načíst přímo, zavolejte členskou funkci CanUpdate dotazu. Další informace najdete v tématu Aktualizovatelná vlastnost v nápovědě k dao.

m_bReturnsRecords
Určuje, jestli předávací dotaz SQL do externí databáze vrací záznamy. Pokud je tato vlastnost TRUE, dotaz vrátí záznamy. Chcete-li přímo načíst tuto vlastnost, zavolejte CDaoQueryDef::GetReturnsRecords. Ne všechny předávací dotazy SQL do externích databází vrací záznamy. Příkaz SQL UPDATE například aktualizuje záznamy bez vrácení záznamů, zatímco příkaz SQL SELECT vrací záznamy. Další informace naleznete v tématu "ReturnsRecords – vlastnost" v nápovědě k dao.

m_strSQL
Příkaz SQL, který definuje dotaz spuštěný objektem querydef. Vlastnost SQL obsahuje příkaz SQL, který určuje, jak jsou při spuštění dotazu vybrány, seskupené a seřazené záznamy. Dotaz můžete použít k výběru záznamů, které chcete zahrnout do objektu sady záznamů dynaset nebo snímku. Můžete také definovat hromadné dotazy pro úpravu dat bez vrácení záznamů. Hodnotu této vlastnosti můžete načíst přímo voláním členské funkce GetSQL querydef.

m_strConnect
Poskytuje informace o zdroji databáze použité v předávacím dotazu. Tyto informace mají formu připojovacího řetězce. Další informace o připojovacích řetězcích a informace o načtení hodnoty této vlastnosti přímo naleznete v CDaoDatabase::GetConnect členské funkce.

m_nODBCTimeout
Počet sekund, po které databázový stroj Microsoft Jet čeká, než dojde k chybě časového limitu při spuštění dotazu v databázi ODBC (Open Database Connectivity). Pokud používáte databázi ODBC, například Microsoft SQL Server, může dojít ke zpoždění kvůli síťovému provozu nebo vysokému využití serveru ODBC. Místo čekání na neomezenou dobu můžete určit, jak dlouho modul Microsoft Jet čeká, než způsobí chybu. Výchozí hodnota časového limitu je 60 sekund. Hodnotu této vlastnosti můžete načíst přímo voláním členské funkce GetODBCTimeout dotazu. Další informace najdete v tématu OdbcTimeout – vlastnost v nápovědě k dao.

Poznámky

Querydef je objekt třídy CDaoQueryDef. Odkazy na Primary, Secondary a All označují, jak jsou informace vráceny GetQueryDefInfo člen funkce ve třídě CDaoDatabase.

Informace načtené CDaoDatabase::GetQueryDefInfo členské funkce jsou uloženy ve struktuře CDaoQueryDefInfo . Volání GetQueryDefInfo databázového objektu, ve které je uložen objekt QueryDefs, je uložen objekt querydef. CDaoQueryDefInfo také definuje členovou Dump funkci v buildech ladění. Můžete použít Dump k výpisu obsahu objektu CDaoQueryDefInfo . Třída CDaoDatabase také poskytuje členské funkce pro přímý přístup ke všem vlastnostem vráceným v objektu CDaoQueryDefInfo , takže zřídka voláte GetQueryDefInfo.

Když do kolekce Pole nebo Parametry objektu querydef připojíte nové pole nebo objekt parametru, vyvolá se výjimka, pokud podkladová databáze nepodporuje datový typ zadaný pro nový objekt.

Nastavení data a času jsou odvozena z počítače, na kterém byl dotaz vytvořen nebo naposledy aktualizován. V prostředí s více uživateli by uživatelé měli tato nastavení získat přímo ze souborového serveru pomocí příkazu net time , aby nedocházelo k nesrovnalostem v nastavení vlastnosti DateCreated a LastUpdated.

Požadavky

Záhlaví: afxdao.h

Viz také

Struktury, styly, zpětná volání a mapy zpráv
CDaoQueryDef – třída
CDaoDatabase – třída

Sdílet prostřednictvím