実行しようとしたコマンドを中止してエラーを発生させるまでの待機時間を示します。
設定値と戻り値
コマンド実行が完了するまでの待機時間を秒単位で示す長整数型 (Long) の値を設定します。また、値の取得も可能です。既定値は 30 です。
解説
ネットワーク トラフィックやサーバーの過負荷により実行が遅れている Execute メソッドの呼び出しの取り消しを行えるようにするには、Connection オブジェクトまたは Command オブジェクトの CommandTimeout プロパティを使います。コマンドの実行が完了する前に CommandTimeout プロパティで設定された時間が経過すると、エラーが発生してコマンドが取り消されます。プロパティに 0 を設定すると、コマンド実行が完了するまで無限に待機します。コードを書き込むプロバイダとデータ ソースが CommandTimeout 機能をサポートしていることを確認してください。
Connection オブジェクトの CommandTimeout 設定は、同じ Connection 上の Command オブジェクトの CommandTimeout 設定に影響しません。つまり、Command オブジェクトの CommandTimeout プロパティは、Connection オブジェクトの CommandTimeout の値を継承しません。
Connection オブジェクトでは、CommandTimeout プロパティは Connection が開かれた後も、読み取り/書き込みができます。