CDaoTableDefInfo-Struktur

Die CDaoTableDefInfo Struktur enthält Informationen zu einem tabledef-Objekt, das für Datenzugriffsobjekte (Data Access Objects, DAO) definiert ist.

Hinweis

DAO wird bis Office 2013 unterstützt. DAO 3.6 ist die endgültige Version und gilt als veraltet.

Syntax

struct CDaoTableDefInfo
{
    CString m_strName;               // Primary
    BOOL m_bUpdatable;               // Primary
    long m_lAttributes;              // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    CString m_strSrcTableName;       // Secondary
    CString m_strConnect;            // Secondary
    CString m_strValidationRule;     // All
    CString m_strValidationText;     // All
    long m_lRecordCount;             // All
};

Parameter

m_strName
Benennt das tabledef-Objekt eindeutig. Rufen Sie die GetName-Memberfunktion des Tabledef-Objekts auf, um den Wert dieser Eigenschaft direkt abzurufen. Weitere Informationen finden Sie im Thema "Name Property" in der DAO-Hilfe.

m_bUpdatable
Gibt an, ob Änderungen an der Tabelle vorgenommen werden können. Die schnelle Möglichkeit, zu bestimmen, ob eine Tabelle aktualisierbar ist, besteht darin, ein CDaoTableDef Objekt für die Tabelle zu öffnen und die CanUpdate-Memberfunktion des Objekts aufzurufen. CanUpdate gibt immer nonzero (TRUE) für ein neu erstelltes tabledef -Objekt und 0 (FALSE) für ein angefügtes tabledef -Objekt zurück. Ein neues tabledef-Objekt kann nur an eine Datenbank angefügt werden, für die der aktuelle Benutzer Schreibberechtigungen besitzt. Wenn die Tabelle nur nicht aktualisierbare Felder enthält, CanUpdate wird 0 zurückgegeben. Wenn mindestens ein Feld aktualisierbar ist, CanUpdate wird "nonzero" zurückgegeben. Sie können nur die aktualisierbaren Felder bearbeiten. Weitere Informationen finden Sie im Thema "Aktualisierbare Eigenschaft" in der DAO-Hilfe.

m_lAttributes
Gibt die Merkmale der Tabelle an, die durch das tabledef -Objekt dargestellt wird. Rufen Sie die getAttributes-Memberfunktion auf, um die aktuellen Attribute einer Tabledef abzurufen. Der zurückgegebene Wert kann eine Kombination dieser langen Konstanten sein (mit dem Bitweise-OR (|)-Operator):

• dbAttachExclusive Für Datenbanken, die das Microsoft Jet-Datenbankmodul verwenden, gibt an, dass die Tabelle eine angefügte Tabelle ist, die zur exklusiven Verwendung geöffnet wird.

• dbAttachSavePWD Gibt für Datenbanken, die das Microsoft Jet-Datenbankmodul verwenden, an, dass die Benutzer-ID und das Kennwort für die angefügte Tabelle mit den Verbindungsinformationen gespeichert werden.

• dbSystemObject Gibt an, dass die Tabelle eine Systemtabelle ist, die vom Microsoft Jet-Datenbankmodul bereitgestellt wird. (Schreibgeschützt.)

• dbHiddenObject Gibt an, dass die Tabelle eine ausgeblendete Tabelle ist, die vom Microsoft Jet-Datenbankmodul (zur temporären Verwendung) bereitgestellt wird. (Schreibgeschützt.)

• dbAttachedTable Gibt an, dass die Tabelle eine angefügte Tabelle aus einer Nicht-ODBC-Datenbank ist, z. B. eine Paradox-Datenbank.

• dbAttachedODBC Gibt an, dass die Tabelle eine angefügte Tabelle aus einer ODBC-Datenbank ist, z. B. Microsoft SQL Server.

m_dateCreated
Das Datum und die Uhrzeit, zu dem die Tabelle erstellt wurde. Rufen Sie zum direkten Abrufen des Erstellungsdatums der Tabelle die GetDateCreated-Memberfunktion des Objekts auf, das CDaoTableDef der Tabelle zugeordnet ist. Weitere Informationen finden Sie unten in den Kommentaren. Verwandte Informationen finden Sie im Thema "DateCreated, LastUpdated Properties" in der DAO-Hilfe.

m_dateLastUpdated
Das Datum und die Uhrzeit der letzten Änderung, die am Entwurf der Tabelle vorgenommen wurde. Um das Datum, an dem die Tabelle zuletzt aktualisiert wurde, direkt abzurufen, rufen Sie die GetDateLastUpdated-Memberfunktion des Objekts auf, das CDaoTableDef der Tabelle zugeordnet ist. Weitere Informationen finden Sie unten in den Kommentaren. Verwandte Informationen finden Sie im Thema "DateCreated, LastUpdated Properties" in der DAO-Hilfe.

m_strSrcTableName
Gibt den Namen einer angefügten Tabelle an, falls vorhanden. Rufen Sie zum direkten Abrufen des Quelltabellennamens die GetSourceTableName-Memberfunktion des Objekts auf, das CDaoTableDef der Tabelle zugeordnet ist.

m_strConnect
Stellt Informationen zur Quelle einer geöffneten Datenbank bereit. Sie können diese Eigenschaft überprüfen, indem Sie die GetConnect-Memberfunktion Ihres CDaoTableDef Objekts aufrufen. Weitere Informationen zu Verbindungszeichenfolgen finden Sie unter GetConnect.

m_strValidationRule
Ein Wert, der die Daten in Tabledef-Feldern überprüft, während sie geändert oder einer Tabelle hinzugefügt werden. Die Überprüfung wird nur für Datenbanken unterstützt, die das Microsoft Jet-Datenbankmodul verwenden. Rufen Sie zum direkten Abrufen der Gültigkeitsprüfungsregel die GetValidationRule-Memberfunktion des Objekts auf, das CDaoTableDef der Tabelle zugeordnet ist. Verwandte Informationen finden Sie im Thema "ValidationRule Property" in der DAO-Hilfe.

m_strValidationText
Ein Wert, der den Text der Nachricht angibt, die von der Anwendung angezeigt werden soll, wenn die durch die ValidationRule-Eigenschaft angegebene Gültigkeitsprüfungsregel nicht erfüllt ist. Verwandte Informationen finden Sie im Thema "ValidationText Property" in der DAO-Hilfe.

m_lRecordCount
Die Anzahl der Datensätze, auf die in einem tabledef-Objekt zugegriffen wird. Diese Eigenschaftseinstellung ist schreibgeschützt. Rufen Sie die GetRecordCount-Memberfunktion des CDaoTableDef Objekts auf, um die Datensatzanzahl direkt abzurufen. In der Dokumentation wird GetRecordCount die Datensatzanzahl weiter beschrieben. Beachten Sie, dass das Abrufen dieser Anzahl ein zeitaufwendiger Vorgang sein kann, wenn die Tabelle viele Datensätze enthält.

Hinweise

Tabledef ist ein Objekt der Klasse CDaoTableDef. Die Verweise auf "Primary", "Secondary" und "All above" geben an, wie die Informationen von der GetTableDefInfo-Memberfunktion in der Klasse CDaoDatabasezurückgegeben werden.

Informationen, die von der Memberfunktion "CDaoDatabase::GetTableDefInfo " abgerufen werden, werden in einer CDaoTableDefInfo Struktur gespeichert. Rufen Sie die GetTableDefInfo Memberfunktion des CDaoDatabase Objekts auf, in dessen TableDefs-Auflistung das Tabledef-Objekt gespeichert ist. CDaoTableDefInfo definiert zudem eine Memberfunktion Dump in Debugbuilds. Sie können Dump verwenden, um den Inhalt eines CDaoTableDefInfo-Objekts auszugeben.

Die Datums- und Uhrzeiteinstellungen werden vom Computer abgeleitet, auf dem die Basistabelle erstellt oder zuletzt aktualisiert wurde. In einer Mehrbenutzerumgebung sollten Benutzer diese Einstellungen direkt vom Dateiserver abrufen, um Diskrepanzen in den Eigenschafteneinstellungen "DateCreated" und "LastUpdated" zu vermeiden.

Anforderungen

Header: afxdao.h

Siehe auch

Strukturen, Stile, Rückrufe und Meldungszuordnungen
CDaoTableDef-Klasse
CDaoDatabase-Klasse