CDaoTableDefInfo 構造体

[アーティクル]
07/19/2022

構造体 CDaoTableDefInfo には、データアクセスオブジェクト (DAO) に対して定義された tabledef オブジェクトに関する情報が含まれています。

構文

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

パラメーター

m_strName
tabledef オブジェクトに一意の名前を付けます。このプロパティの値を直接取得するには、tabledef オブジェクトの GetName メンバー関数を呼び出します。詳細については、DAO ヘルプの「Name プロパティ」のトピックを参照してください。

m_bUpdatable
テーブルに変更を加えることができるかどうかを示します。テーブルが更新可能かどうかを判断する簡単な方法は、テーブルのオブジェクトを CDaoTableDef 開き、オブジェクトの CanUpdate メンバー関数を呼び出す方法です。 CanUpdate は、新しく作成された tabledef オブジェクトの場合は常に 0 以外 (TRUE) を返し、アタッチされた tabledef オブジェクトの場合は 0 (FALSE) を返します。新しい tabledef オブジェクトは、現在のユーザーが書き込みアクセス許可を持っているデータベースにのみ追加できます。テーブルに非有効なフィールドのみが含まれている場合は、 CanUpdate 0 を返します。 1 つ以上のフィールドが更新可能な場合は、 CanUpdate 0 以外の値を返します。更新可能なフィールドのみを編集できます。詳細については、DAO ヘルプの「更新可能なプロパティ」のトピックを参照してください。

m_lAttributes
tabledef オブジェクトによって表されるテーブルの特性を指定します。 tabledef の現在の属性を取得するには、その GetAttributes メンバー関数を呼び出します。返される値は、(ビットごとの OR (|) 演算子を使用して) これらの長い定数の組み合わせにすることができます。

dbAttachExclusive Microsoft Jet データベースエンジンを使用するデータベースの場合、テーブルが排他的に使用するために開かれた添付テーブルであることを示します。
dbAttachSavePWD Microsoft Jet データベースエンジンを使用するデータベースの場合は、接続情報と共に添付テーブルのユーザー ID とパスワードが保存されることを示します。
dbSystemObject テーブルが Microsoft Jet データベースエンジンによって提供されるシステムテーブルであることを示します。システムテーブルは読み取り専用です。
dbHiddenObject テーブルが Microsoft Jet データベースエンジンによって提供される非表示テーブルであることを示します (一時的な使用)。システムテーブルは読み取り専用です。
dbAttachedTable テーブルが、Paradox データベースなどの ODBC 以外のデータベースからアタッチされたテーブルであることを示します。
dbAttachedODBCテーブルが ODBC データベースからアタッチされたテーブル (Microsoft SQL Server など) であることを示します。

m_dateCreated
テーブルが作成された日時。テーブルが作成された日付を直接取得するには、テーブルに関連付けられているオブジェクトの CDaoTableDefGetDateCreated メンバー関数を呼び出します。詳細については、以下のコメントを参照してください。関連情報については、DAO ヘルプの「DateCreated,LastUpdated プロパティ」を参照してください。

m_dateLastUpdated
テーブルのデザインに対して行われた最新の変更の日時。テーブルが最後に更新された日付を直接取得するには、テーブルに関連付けられているオブジェクトの CDaoTableDefGetDateLastUpdated メンバー関数を呼び出します。詳細については、以下のコメントを参照してください。関連情報については、DAO ヘルプの「DateCreated,LastUpdated プロパティ」を参照してください。

m_strSrcTableName
アタッチされたテーブルの名前 (存在する場合) を指定します。ソーステーブル名を直接取得するには、テーブルに関連付けられているオブジェクトの CDaoTableDefGetSourceTableName メンバー関数を呼び出します。

m_strConnect
開いているデータベースのソースに関する情報を提供します。このプロパティを確認するには、オブジェクトの GetConnect メンバー関数を CDaoTableDef 呼び出します。接続文字列の詳細については、次を参照してください GetConnect。

m_strValidationRule
テーブルに変更または追加された tabledef フィールドのデータを検証する値。検証は、Microsoft Jet データベースエンジンを使用するデータベースでのみサポートされます。検証規則を直接取得するには、テーブルに関連付けられているオブジェクトの CDaoTableDefGetValidationRule メンバー関数を呼び出します。関連情報については、DAO ヘルプの「ValidationRule プロパティ」を参照してください。

m_strValidationText
ValidationRule プロパティで指定された検証規則が満たされていない場合にアプリケーションが表示するメッセージのテキストを指定する値。関連情報については、DAO ヘルプの「ValidationText プロパティ」を参照してください。

m_lRecordCount
tabledef オブジェクトでアクセスされるレコードの数。このプロパティ設定は読み取り専用です。レコード数を直接取得するには、オブジェクトの GetRecordCount メンバー関数を CDaoTableDef 呼び出します。このドキュメント GetRecordCount では、レコード数をさらに詳しく説明します。テーブルに多数のレコードが含まれている場合、この数の取得は時間のかかる操作になる可能性があることに注意してください。

解説

tabledef は CDaoTableDef クラスのオブジェクトです。上記の Primary、Secondary、All への参照は、クラスCDaoDatabaseの GetTableDefInfo メンバー関数によって情報がどのように返されるかを示しています。

CDaoDatabase::GetTableDefInfo メンバー関数によって取得された情報は、構造体にCDaoTableDefInfo格納されます。 GetTableDefInfo TableDefs コレクションに CDaoDatabase tabledef オブジェクトが格納されているオブジェクトのメンバー関数を呼び出します。 CDaoTableDefInfo では、デバッグビルドで Dump メンバー関数も定義します。 Dump を使用して、CDaoTableDefInfo オブジェクトの内容をダンプすることができます。

日付と時刻の設定は、ベーステーブルが作成または最後に更新されたコンピューターから派生します。マルチユーザー環境では、DateCreated プロパティと LastUpdated プロパティ設定の不一致を回避するために、ユーザーはファイルサーバーからこれらの設定を直接取得する必要があります。

必要条件

ヘッダー: afxdao.h

CDaoTableDefInfo 構造体

構文

パラメーター

解説

必要条件

関連項目