CommandTimeout プロパティ (ADO)

コマンドの実行中に待機してから試行を終了し、エラーを生成する時間を示します。

設定と戻り値

コマンドの実行を待機する時間を秒単位で示す長 値を を設定または返します。 既定値は 30 です。

備考

Connection オブジェクトまたは Command オブジェクトで CommandTimeout プロパティを使用すると、ネットワーク トラフィックの遅延やサーバーの使用が多いため、Execute メソッド呼び出しを取り消すことができるようになります。 コマンドの実行が完了する前に、CommandTimeout プロパティに設定された間隔が経過すると、エラーが発生し、ADO によってコマンドが取り消されます。 プロパティを 0 に設定すると、ADO は実行が完了するまで無期限に待機します。 コードを記述するプロバイダーとデータ ソースで、CommandTimeout 機能がサポートされていることを確認します。

Connection オブジェクトの CommandTimeout 設定は、同じ 接続上の Command オブジェクトの CommandTimeout 設定には影響しません。つまり、Command オブジェクトの CommandTimeout プロパティは、Connection オブジェクトの CommandTimeout 値の値を継承しません。

Connection オブジェクトでは、接続 を開いた後も、CommandTimeout プロパティは読み取り/書き込みのままです。

適用対象

Command オブジェクト (ADO)

Connection オブジェクト (ADO)

関連項目

ActiveConnection、CommandText、CommandTimeout、CommandType、Size、および Direction プロパティの使用例 (VB)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size、Direction プロパティの使用例 (VC++)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size、Direction プロパティの使用例 (JScript)
ConnectionTimeout プロパティ (ADO)