CDaoQueryDefInfo-Struktur

Die CDaoQueryDefInfo-Struktur enthält Informationen über ein Querydef-Objekt, das für Datenzugriffsobjekte (DAO) definiert ist.

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

Parameter

  • m_strName
    Eindeutig Namen der Querydef-Objekt.Weitere Informationen finden Sie im Thema "Name-Eigenschaft" in der DAO-Hilfe.CDaoQueryDef::GetName Aufruf, um diese Eigenschaft direkt abzurufen.

  • m_nType
    Ein Wert, der den Typ der das Durchführen eines Querydef-Objekts angibt.Der Wert kann einer der folgenden Werte sein:

    • dbQSelect ausgewählt — Abfrage wählt Datensätze aus.

    • dbQAction — Aktion wird die Abfrage ändern oder die Daten jedoch keine Datensätze zurück.

    • dbQCrosstab Kreuztabelle — Die Abfrage gibt die Daten in einem Arbeitsblatt ähnlichen Format zurück.

    • dbQDelete Löschen der die Abfrage löscht einen Satz angegebenen Zeilen.

    • dbQUpdate Aktualisierung:Die Abfrage wird eine Gruppe von Datensätzen.

    • dbQAppend angefügt — Abfrage fügt neue Datensätze am Ende einer Tabelle oder einer Abfrage hinzufügen.

    • dbQMakeTable Machen-Tabelle — Die Abfrage wird eine neue Tabelle aus einem Recordset.

    • Datendefinition —dbQDDL die Abfrage wirkt sich auf die Struktur der Tabellen bzw. deren Teile.

    • dbQSQLPassThrough Durchgang — Die SQL-Anweisung wird direkt an den back-end Datenbank ohne Bildsegmentierung übergeben.

    • dbQSetOperation Union — Abfrage erstellt ein Recordset-Objekt vom Typ Momentaufnahme, die Daten aus allen angegebenen Datensätzen in zwei oder mehr Tabellen mit einem doppelten Datensätze entfernt.Um die Duplikate einzuschließen, fügen Sie das Schlüsselwort ALLE in der SQL-Anweisung der Querydefs hinzu.

    • dbQSPTBulk verwendete mit dbQSQLPassThrough, um eine Abfrage angegeben werden, die keine Datensätze zurückgibt.

    HinweisHinweis

    Um eine SQL Pass-Through-Abfrage zu erstellen, legen Sie nicht die dbQSQLPassThrough Konstante fest.Dies wird automatisch durch das Microsoft Jet-Datenbankmodul festgelegt, wenn Sie ein Querydef-Objekt erstellen und die Verbindung Eigenschaft festlegen.

    Weitere Informationen finden Sie im Thema "Typeigenschaft" in der DAO-Hilfe.

  • m_dateCreated
    Das Datum und die Uhrzeit, zu der die Querydef erstellt wurde.Um das Datum direkt abzurufen, das die Querydef erstellt, die GetDateCreated-Memberfunktion des Objekts CDaoTableDef Aufrufen von wurde, das der Tabelle zugeordnet ist.Zeigen Sie Kommentare unten.Siehe auch im Thema "DateCreated, LastUpdated-Eigenschaften" in der DAO-Hilfe.

  • m_dateLastUpdated
    Das Datum und die Uhrzeit der letzten Änderung an der Querydef vorgenommen.Um das Datum direkt abzurufen, das die Tabelle zuletzt aktualisiert, die Querydefs der Memberfunktion GetDateLastUpdated Aufrufen von wurde.Zeigen Sie Kommentare unten.Und finden Sie im Thema "DateCreated, LastUpdated-Eigenschaften" in der DAO-Hilfe.

  • m_bUpdatable
    Gibt an, ob Änderungen an einem Querydef-Objekt vorgenommen werden können.Wenn diese Eigenschaft TRUE ist, ist die Querydef aktualisierbar; andernfalls ist sie nicht.Aktualisierbar bedeutet, dass die Abfragedefinition des Querydef-Objekts geändert werden kann.Die aktualisierbare Eigenschaft eines Querydef-Objekts wird auf TRUE festgelegt, wenn die Abfragedefinition aktualisiert werden kann, auch wenn das resultierende Recordset nicht aktualisierbar ist.Um diese Eigenschaft direkt abzurufen, rufen Sie die CanUpdate-Memberfunktion der Querydefs an.Weitere Informationen finden Sie im Thema "aktualisierbare Eigenschaft" in der DAO-Hilfe.

  • m_bReturnsRecords
    Gibt an, ob eine SQL Pass-Through-Abfrage in einer externen Datenbank Datensätze zurückliefert.Wenn diese Eigenschaft TRUE ist, gibt die Abfrage Datensätzen zurück.Um diese Eigenschaft direkt abrufen, rufen Sie CDaoQueryDef::GetReturnsRecords.Nicht alle SQL Pass-Through-Abfragen Datensätze der Rückgabe an externe Datenbanken.Zum Beispiel aktualisiert eine Anweisung ohne Datensätze AKTUALISIEREN SQL Datensätze zurückzugeben, während eine Anweisung SQL SELECT Datensätze zurückliefert.Weitere Informationen finden Sie im Thema "ReturnsRecords-Eigenschaft" in der DAO-Hilfe.

  • m_strSQL
    Die SQL-Anweisung, die die Abfrage definiert, die von einem Querydef-Objekt aus.Die SQL-Anweisung, die die SQL-Eigenschaft enthält, z. B. Datensätze ausgewählt sind, gruppiert und sortiert, wenn Sie die Abfrage ausführen.Sie können die Abfrage verwenden, um Datensätze auswählen, die in einem Dynaset oder Recordset-Objekt eingeschlossen in einem vom Typ Momentaufnahme.Sie können auch festlegen, dass Abfragen Großteil Daten ändern, ohne Datensätze zurückzugeben.Sie können den Wert dieser Eigenschaft direkt abrufen, indem Sie die GetSQL-Memberfunktion der Querydefs aufrufen.

  • m_strConnect
    Stellt Informationen zur Quelle einer Datenbank bereit, die in einer Pass-Through-Abfrage verwendet wird.Diese Informationen akzeptieren die Form einer Zeichenfolge Verbindung an.Weitere Informationen über Zeichenfolgen und schließen Sie Informationen zu den Wert dieser Eigenschaft direkt abrufen, finden CDaoDatabase::GetConnect die Memberfunktion auf.

  • m_nODBCTimeout
    Die Anzahl von Sekunden, die das Microsoft Jet-Datenbankmodul wartet, bevor ein Timeoutfehler auftritt, wenn eine Abfrage auf eine ODBC-Datenbank ausgeführt wird.Wenn Sie eine ODBC-Datenbank, z. B. Microsoft SQL Server verwenden, gibt es möglicherweise Verzögerungen aufgrund des Netzwerkdatenverkehrs oder intensiven Beanspruchung des ODBC-Servers.Statt unbegrenzt gewartet haben, können Sie angeben, wie lange das Microsoft Jet-Modul wartet, bevor er einen Fehler generiert.Der standardmäßige Timeoutwert ist 60 Sekunden.Sie können den Wert dieser Eigenschaft direkt abrufen, indem Sie die GetODBCTimeout-Memberfunktion der Querydefs aufrufen.Weitere Informationen finden Sie im Thema "ODBCTimeout-Eigenschaft" in der DAO-Hilfe.

Hinweise

Die Querydef ist ein Objekt der Klasse CDaoQueryDef.Die Verweise auf primärem und sekundärem, werden alle oben zeigen an, wie die Informationen über die GetQueryDefInfo-Memberfunktion der Klasse CDaoDatabase zurückgegeben werden.

Die Informationen, die von der CDaoDatabase::GetQueryDefInfo-Memberfunktion abgerufen werden, werden in einer CDaoQueryDefInfo-Struktur gespeichert.Rufen Sie GetQueryDefInfo für das Datenbankobjekt an, auf dessen Querydef der Auflistung Querydef-Objekt gespeichert wird.CDaoQueryDefInfo definiert auch eine Dump-Memberfunktion in Debugbuilds.Sie können Dump verwenden, um den Inhalt eines CDaoQueryDefInfo-Objekts zu speichern.Darüber hinaus stellt Memberfunktionen von Klassen CDaoDatabase für alle Eigenschaften direkt zugreifen, die in einem CDaoQueryDefInfo-Objekt, das zurückgegeben werden, müssen Sie sich selten GetQueryDefInfo aufrufen.

Wenn Sie ein neues Feld- oder Parameterobjekt den Feldern oder der Parameterauflistung eines Querydef-Objekts anfügen, wird eine Ausnahme ausgelöst, wenn die zugrunde liegende Datenbank nicht den Datentyp unterstützt, der für das neue Objekt angegeben wird.

Die Datums- und Uhrzeiteinstellungen sind vom Computer abgeleitet, auf dem die Querydef erstellt oder zuletzt aktualisiert wurde.In einer Mehrbenutzerumgebung können Benutzer diese Einstellungen direkt vom Dateiserver mit dem net time Befehls abgerufen werden, Diskrepanzen in den Eigenschafteneinstellungen DateCreated und LastUpdated zu vermeiden.

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CDaoQueryDef-Klasse

CDaoDatabase-Klasse

Weitere Ressourcen

Strukturen, Formate, Rückrufe und Meldungszuordnungen