CDaoQueryDefInfo 構造

CDaoQueryDefInfo構造は次の形式をが:

構造体 CDaoQueryDefInfo{特価;CString の m_strName;//プライマリ短い m_nType;//プライマリCOleDateTime m_dateCreated;//セカンダリCOleDateTime m_dateLastUpdated;//セカンダリBOOL m_bUpdatable;//セカンダリBOOL m_bReturnsRecords;//セカンダリCString の m_strSQL;//すべてCString の m_strConnect;//すべて短い m_nODBCTimeout;//すべて}(&N)

CDaoQueryDefInfo構造には、データ アクセス オブジェクト (DAO) の定義、クエリ定義オブジェクトに関する情報が含まれます。クエリ定義は、 CDaoQueryDefクラスのオブジェクトです。どのように情報クラスCDaoDatabaseのGetQueryDefInfoメンバー関数によって返されるプライマリ、セカンダリ、上記のすべての参照を示す。

メンバー

m_strName

クエリ定義オブジェクトの一意名します。詳細については、DAO ヘルプの「名前プロパティ」を参照してください。このプロパティを直接取得するには、 CDaoQueryDef::GetNameを呼び出す。

m_nType

クエリ定義オブジェクトの操作の種類を示す値。値は、次のいずれかをすることができます。:

• dbQSelect特価;選択 ? レコード クエリを選択します。(&N)。
  
  
• dbQAction特価;アクション ? クエリ移動データの変更がレコードを返さない(&N)。
  
  
• dbQCrosstab特価;クロス集計 ? データをスプレッドシートに似た形式で返されます(&N)。
  
  
• dbQDelete特価;削除 ? 指定した行セットのクエリを削除します(&N)。
  
  
• dbQUpdate特価;更新-クエリ レコード セットを変更します。(&N)。
  
  
• dbQAppend特価;追加 ? クエリの新しいレコードのテーブルまたはクエリの最後が追加されます。(&N)。
  
  
• dbQMakeTable特価;テーブル ? クエリ新しいテーブルからのレコード セットを作成します。(&N)。
  
  
• dbQDDL特価;? データ定義クエリ テーブルまたはその部分の構造に影響を与える(&N)。
  
  
• dbQSQLPassThrough特価;パススルー ? 中間処理せず、データベース バックエンドに直接 SQL ステートメントを渡される(&N)。
  
  
• dbQSetOperation特価;Union ? クエリ削除重複するレコードが 2 つ以上のテーブルで指定したすべてのレコードからのデータを含むスナップショット タイプのレコード セット オブジェクトを作成します。重複を含めるには、すべてのキーワード、クエリ定義の SQL ステートメントの追加します。(&N)。
  
  
• dbQSPTBulk特価;DbQSQLPassThroughがレコードを返さないクエリを指定するために使用(&N)。

  注特価;SQL パススルー クエリを作成するには、 dbQSQLPassThrough定数は設定しません。自動的に、クエリ定義オブジェクトを作成するときに接続プロパティを設定すると、Microsoft Jet データベース エンジンによってに設定します。(&N)。

  詳細については、DAO ヘルプの「Type プロパティ」のトピックを参照してください。

m_dateCreated

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

m_dateLastUpdated

日付と時刻にクエリ定義の最も最近の変更のします。直接、テーブルが最後に更新された日付を取得するには、クエリ定義のGetDateLastUpdatedメンバー関数を呼び出します。以下のコメントの詳細についてを参照してください。DAO のヘルプでトピック「DateCreated、LastUpdated プロパティ」を参照してください。

m_bUpdatable

クエリ定義オブジェクトを変更することができるかどうかを示します。このプロパティがTRUEの場合は、クエリ定義は更新可能です。それ以外の場合、これではありません。更新可能なクエリ定義オブジェクトのクエリ定義を変更することができることを意味します。クエリ定義を更新できる場合は、結果のレコード セットが更新可能ではない場合でも、クエリ定義オブジェクトのプロパティがTRUEに設定されます。このプロパティを直接取得するには、クエリ定義のCanUpdateメンバー関数を呼び出します。詳細については、DAO ヘルプの「更新可能なプロパティ」のトピックを参照してください。

m_bReturnsRecords

外部データベース、SQL パススルー クエリがレコードを返すかどうかを示します。このプロパティがTRUEの場合は、レコードが返されます。このプロパティを直接取得するには、 CDaoQueryDef::GetReturnsRecordsを呼び出します。外部データベースへのすべての SQL パススルー クエリのレコードを返します。たとえば、SQL更新ステートメントは SQL選択ステートメントがレコードを返すことが、レコードを返さずにレコードを更新します。詳細については、DAO ヘルプの「レコードのプロパティ」トピックを参照してください。

m_strSQL

クエリ定義オブジェクトによって実行されるクエリを定義する SQL ステートメント。SQL プロパティには、選択クエリを実行するとどのようにレコード、グループ化、および順序指定されているを決定する SQL ステートメントが含まれます。ダイナセット タイプまたはスナップショット タイプの recordset オブジェクトに含めるレコードを選択するのにには、クエリを使用できます。レコードを返さずにデータを変更するには、一括クエリを定義することもできます。このプロパティの値は、クエリ定義のGetSQLメンバー関数を直接呼び出すことによって取得できます。詳細については、参照してください DAO クエリでVisual の C++ プログラマのガイドと DAO のヘルプで「SQL プロパティ」のトピック。

m_strConnect

パススルー クエリで使用されるデータベースのソースについての情報を提供します。この情報は接続文字列の形式をとります。詳細について文字列を接続し、このプロパティの値を直接取得する方法については、 CDaoDatabase::GetConnectメンバー関数を参照してください。

m_nODBCTimeout

ODBC データベースにクエリを実行すると、タイムアウト エラーが発生する前に、Microsoft Jet データベース エンジンが待機する秒数を発生します。Microsoft SQL Server などの ODBC データベースを使用している場合があります遅延ネットワーク トラフィックまたは重、ODBC サーバーを使用するため。いつまでも待っているではなく、エラーを生成する前に Microsoft jet データベース エンジンを待機する時間を指定できます。既定のタイムアウト値は 60 秒です。このプロパティの値は、クエリ定義のGetODBCTimeoutメンバー関数を直接呼び出すことによって取得できます。詳細については、DAO ヘルプの「Connectivity」トピックを参照してください。

コメント

CDaoDatabase::GetQueryDefInfoメンバー関数によって取得された情報は、 CDaoQueryDefInfo構造体に格納されます。GetQueryDefInfoのデータベース オブジェクトは、QueryDefs コレクションにクエリ定義オブジェクトは格納されますを呼び出します。CDaoQueryDefInfoもデバッグ ビルドでは、 Dumpメンバー関数を定義します。ダンプを使用して、 CDaoQueryDefInfoオブジェクトの内容をダンプすることができます。クラスCDaoDatabaseも直接すべてのおそらくほとんどGetQueryDefInfoを呼び出す必要がありますので、 CDaoQueryDefInfoオブジェクトで返されるプロパティにアクセスするためのメンバー関数を提供します。

クエリ定義オブジェクトのフィールドまたはパラメーターのコレクションに新しいフィールドまたはパラメーター オブジェクトを追加すると、基になるデータベースが新しいオブジェクトに指定したデータ型をサポートしていない場合、例外がスローされます。

日付と時刻の設定は、クエリ定義が作成または更新するのには、コンピューターから派生しています。マルチ ユーザー環境では、ユーザーはこれらの設定で、DateCreated 食い違いを避けるために、 net timeコマンドを使用してサーバーから直接ファイルと LastUpdated プロパティの設定を得る必要があります。これと他の MFC DAO 情報構造体の使用方法については、参照してください DAO コレクション: DAO オブジェクトの情報の取得でVisual の C++ プログラマのガイド。

参照特価;CDaoQueryDef、 CDaoDatabase(&N)