CDaoDatabase::SetQueryTimeout

更新 : 2007 年 11 月

接続されているデータベースがその後の操作でタイムアウトとなる秒数の既定値をオーバーライドします。

void SetQueryTimeout( 
   short nSeconds  
);

パラメータ

  • nSeconds
    クエリがタイムアウトになる秒数。

解説

ネットワーク アクセスの問題、クエリの処理時間の超過などで、操作がタイムアウトすることがあります。クエリのタイムアウト値を変更する場合は、レコードセットのオープン、またはレコードセットの AddNewUpdate、または Delete メンバ関数の呼び出し以前に、SetQueryTimeout を呼び出します。設定は、この CDaoDatabase オブジェクトに関連付けられたレコードセットでの、その後のすべての OpenAddNewUpdate、および Delete の呼び出しに影響します。レコードセットを開いた後にクエリのタイムアウト値を変更しても、レコードセットには変更後の値が適用されません。たとえば、値を変更してから Move 操作を実行しても、新しい値は使用されません。

クエリ タイムアウトの既定値は 60 秒です。すべてのデータベースがクエリ タイムアウト値の設定機能をサポートしているわけではありません。クエリ タイムアウト値に 0 を設定すると、タイムアウトは発生せず、データベースとの通信で応答が停止することがあります。この動作は、開発時には有用です。

関連情報については、DAO ヘルプの「QueryTimeout Property」を参照してください。

必要条件

ヘッダー : afxdao.h

参照

参照

CDaoDatabase クラス

階層図

CDaoWorkspace::SetLoginTimeout

その他の技術情報

CDaoDatabase のメンバ