ODBCConnection.Refresh メソッド (Excel)

ODBC 接続を更新します。

構文

expression.Refresh

式ODBCConnection オブジェクトを表す変数。

注釈

ODBC データ ソースへの接続時に、Microsoft Excel は Connection プロパティで指定された接続文字列を使用します。 この接続文字列の情報が十分でない場合、必要な情報をユーザーに確認するダイアログ ボックスが表示されます。 DisplayAlerts プロパティが False に設定されている場合、ダイアログ ボックスが表示されず、不十分な接続情報の例外によって Refresh メソッドは失敗します。

Excel が接続に成功すると、完了した接続文字列が格納され、同じ編集セッション中に Refresh メソッドの後続の呼び出しに対するプロンプトが表示されなくなります。 完全な接続文字列は、 Connection プロパティの値を調べることによって取得できます。

データベース接続が確立すると、SQL クエリの妥当性が確認されます。 クエリが有効でない場合、SQL 構文エラーの例外で Refresh メソッドは失敗します。

クエリにパラメーターが必要な場合は、Refresh メソッドが呼び出される前に、パラメーター バインド情報を使用して Parameters コレクションを初期化する必要があります。 結合しているパラメーターが不十分な場合、Refresh メソッドはパラメーター エラー例外で失敗します。 パラメーターが値のプロンプトに設定されている場合、 DisplayAlerts プロパティの設定に関係なく、ダイアログ ボックスがユーザーに表示されます。 パラメーターを指定するダイアログ ボックスをユーザーがキャンセルすると、Refresh メソッドは停止し、False を返します。 追加のパラメーターが Parameters コレクションにバインドされている場合、これらの追加パラメーターは無視されます。

クエリが正常に完了するか、開始されると、Refresh メソッドは True を返します。接続文字列またはパラメーターを指定するダイアログ ボックスをユーザーがキャンセルすると、このメソッドは False を返します。

フェッチされた行の数がワークシートの使用可能な行数を超えたかどうかを確認するには、 FetchedRowOverflow プロパティを調べます。 このプロパティは、 Refresh メソッドを呼び出すたびに初期化されます。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。