Share via

Structuur CDaoQueryDefInfo

Opmerking

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

De CDaoQueryDefInfo structuur bevat informatie over een querydef-object dat is gedefinieerd voor data access-objecten (DAO).

Opmerking

Data Access Object (DAO) wordt ondersteund via Office 2013. DAO 3.6 is de definitieve versie en is verouderd.

Syntaxis

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

Parameterwaarden

m_strName
Noem het querydef-object een unieke naam. Zie het onderwerp 'Naameigenschap' in DAO Help voor meer informatie. Roep CDaoQueryDef::GetName aan om deze eigenschap rechtstreeks op te halen.

m_nType
Een waarde die het operationele type van een querydef-object aangeeft. De waarde kan een van de volgende zijn:

  • dbQSelect Selecteer: de query selecteert records.

  • dbQAction Actie: de query verplaatst of wijzigt gegevens, maar retourneert geen records.

  • dbQCrosstab Kruistabel: de query retourneert gegevens in een spreadsheetachtige indeling.

  • dbQDelete Verwijderen: met de query wordt een set opgegeven rijen verwijderd.

  • dbQUpdate Bijwerken: de query wijzigt een set records.

  • dbQAppend Toevoegen: met de query worden nieuwe records toegevoegd aan het einde van een tabel of query.

  • dbQMakeTable Tabel maken: met de query wordt een nieuwe tabel gemaakt op basis van een recordset.

  • dbQDDL Gegevensdefinitie: de query is van invloed op de structuur van tabellen of de bijbehorende onderdelen.

  • dbQSQLPassThrough Pass-through: de SQL-instructie wordt rechtstreeks doorgegeven aan de back-end van de database, zonder tussenliggende verwerking.

  • dbQSetOperation Samenvoeging: de query maakt een recordsetobject van het momentopnametype met gegevens uit alle opgegeven records in twee of meer tabellen, waarbij dubbele records worden verwijderd. Als u de duplicaten wilt opnemen, voegt u het trefwoord ALL toe in de SQL-instructie van de querydef.

  • dbQSPTBulk dbQSQLPassThrough Wordt gebruikt om een query op te geven die geen records retourneert.

Opmerking

Als u een SQL Pass Through-query wilt maken, stelt u de dbQSQLPassThrough constante niet in. Dit wordt automatisch ingesteld door de Microsoft Jet-database-engine wanneer u een querydef-object maakt en de Connect eigenschap instelt.

Zie het onderwerp 'Eigenschap type' in DAO Help voor meer informatie.

m_dateCreated
De datum en tijd waarop de querydef is gemaakt. Als u rechtstreeks de datum wilt ophalen waarop de querydef is gemaakt, roept u de lidfunctie GetDateCreated aan van het CDaoTableDef object dat aan de tabel is gekoppeld. Zie Opmerkingenvoor meer informatie. Zie ook het onderwerp DateCreated, LastUpdated Properties in DAO Help.

m_dateLastUpdated
De datum en tijd van de meest recente wijziging in de querydef. Als u de datum waarop de tabel voor het laatst is bijgewerkt, wilt ophalen, roept u de lidfunctie GetDateLastUpdated van de querydef aan. Zie Opmerkingenvoor meer informatie. Zie ook het onderwerp DateCreated, LastUpdated Properties in DAO Help.

m_bUpdatable
Hiermee wordt aangegeven of wijzigingen kunnen worden aangebracht in een querydef-object. Als deze eigenschap TRUE is, kan de querydef worden bijgewerkt; anders is het niet. Kan worden bijgewerkt, betekent dat de querydefinitie van het querydef-object kan worden gewijzigd. De eigenschap Updatable van een querydef-object is ingesteld op TRUE als de querydefinitie kan worden bijgewerkt, zelfs als de resulterende recordset niet kan worden bijgewerkt. Als u deze eigenschap rechtstreeks wilt ophalen, roept u de CanUpdate-lidfunctie van de querydef aan. Zie het onderwerp 'Eigenschap kan worden bijgewerkt' in DAO Help voor meer informatie.

m_bReturnsRecords
Geeft aan of een SQL Pass Through-query naar een externe database records retourneert. Als deze eigenschap WAAR is, retourneert de query records. Als u deze eigenschap rechtstreeks wilt ophalen, roept u CDaoQueryDef::GetReturnsRecords aan. Niet alle SQL Pass Through-query's naar externe databases retourneren records. Een SQL UPDATE-instructie werkt bijvoorbeeld records bij zonder records te retourneren, terwijl een SQL SELECT-instructie records retourneert. Zie het onderwerp ReturnsRecords Property in DAO Help voor meer informatie.

m_strSQL
De SQL-instructie waarmee de query wordt gedefinieerd die wordt uitgevoerd door een querydef-object. De SQL-eigenschap bevat de SQL-instructie die bepaalt hoe records worden geselecteerd, gegroepeerd en geordend wanneer u de query uitvoert. U kunt de query gebruiken om records te selecteren die moeten worden opgenomen in een recordsetobject van het type dynaset of momentopname. U kunt ook bulkquery's definiëren om gegevens te wijzigen zonder records te retourneren. U kunt de waarde van deze eigenschap rechtstreeks ophalen door de getSQL-lidfunctie van querydef aan te roepen.

m_strConnect
Bevat informatie over de bron van een database die wordt gebruikt in een passthrough-query. Deze informatie heeft de vorm van een verbindingsreeks. Zie de functie CDaoDatabase::GetConnect member voor meer informatie over het rechtstreeks ophalen van de waarde van deze eigenschap.

m_nODBCTimeout
Het aantal seconden dat de Microsoft Jet-database-engine wacht voordat er een time-outfout optreedt wanneer een query wordt uitgevoerd op een ODBC-database (Open Database Connectivity). Wanneer u een ODBC-database gebruikt, zoals Microsoft SQL Server, kan er vertraging optreden vanwege netwerkverkeer of intensief gebruik van de ODBC-server. In plaats van voor onbepaalde tijd te wachten, kunt u opgeven hoe lang de Microsoft Jet-engine wacht voordat er een fout optreedt. De standaardtime-outwaarde is 60 seconden. U kunt de waarde van deze eigenschap rechtstreeks ophalen door de getODBCTimeout-lidfunctie van de querydef aan te roepen. Zie het onderwerp ODBCTimeout Property in DAO Help voor meer informatie.

Opmerkingen

De querydef is een object van klasse CDaoQueryDef. De verwijzingen naar Primair, Secundair en Alle geven aan hoe de informatie wordt geretourneerd door de functie GetQueryDefInfo-lid in klasse CDaoDatabase.

Informatie die wordt opgehaald door de CDaoDatabase::GetQueryDefInfo-lidfunctie wordt opgeslagen in een CDaoQueryDefInfo structuur. Aanroep GetQueryDefInfo voor het databaseobject in wiens QueryDefs-verzameling het querydef-object is opgeslagen. CDaoQueryDefInfo definieert ook een Dump lidfunctie in builds voor foutopsporing. U kunt Dump de inhoud van een CDaoQueryDefInfo object dumpen. Klasse CDaoDatabase biedt ook lidfuncties voor rechtstreekse toegang tot alle eigenschappen die in een CDaoQueryDefInfo object worden geretourneerd, zodat u zelden aanroept GetQueryDefInfo.

Wanneer u een nieuw veld of parameterobject toevoegt aan de verzameling Velden of Parameters van een querydef-object, wordt er een uitzondering gegenereerd als de onderliggende database geen ondersteuning biedt voor het gegevenstype dat is opgegeven voor het nieuwe object.

De datum- en tijdinstellingen worden afgeleid van de computer waarop de querydef is gemaakt of voor het laatst is bijgewerkt. In een omgeving met meerdere gebruikers moeten gebruikers deze instellingen rechtstreeks van de bestandsserver ophalen met behulp van de opdracht Net Time om discrepanties te voorkomen in de instellingen van de eigenschap DateCreated en LastUpdated.

Requirements

Rubriek:afxdao.h

Zie ook

Structuren, stijlen, callbacks en berichttoewijzingen
CDaoQueryDef-klasse
CDaoDatabase-klasse

  • Last updated on