ODBCConnection.Refresh メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ODBC 接続を更新します。
public:
void Refresh();public void Refresh ();Public Sub Refresh ()注釈
ODBC データ ソースへの接続時に、 プロパティで指定された接続文字列がConnection使用されます。 この接続文字列の情報が十分でない場合、必要な情報をユーザーに確認するダイアログ ボックスが表示されます。 プロパティが DisplayAlertsFalse の場合、ダイアログ ボックスは表示されず、 Refresh() メソッドは不十分な接続情報例外で失敗します。
Microsoft Excel は接続に成功すると、完了した接続文字列を格納し、同じ編集セッション中にメソッドの後続の呼び出しに対するRefresh()プロンプトが表示されないようにします。 プロパティの値を調べることで、完了した接続文字列をConnection取得できます。
データベース接続が確立すると、SQL クエリの妥当性が確認されます。 クエリが無効な場合、 Refresh() メソッドは SQL 構文エラー例外で失敗します。
クエリにパラメーターが必要な場合は、メソッドを Parameters 呼び出す前に、パラメーター バインド情報を使用してコレクションを初期化する Refresh() 必要があります。 十分なパラメーターがバインドされていない場合、メソッドは Refresh() パラメーター エラー例外で失敗します。 パラメーターを設定して値の入力を求める場合、プロパティの設定に関係なく、ダイアログ ボックスがユーザーに DisplayAlerts 表示されます。 ユーザーがパラメーター ダイアログ ボックスを取り消すと、メソッドは Refresh() 停止し、 False を返します。 コレクションに追加のパラメーターが Parameters バインドされている場合、これらの追加パラメーターは無視されます。
クエリが正常に完了または開始された場合、 Refresh() メソッドは True を 返します。ユーザーが接続またはパラメーターダイアログ ボックスをキャンセルした場合は False を 返します。
フェッチされた行の数がワークシートの使用可能な行数を超えたかどうかを確認するには、 プロパティを FetchedRowOverflow 調べます。 このプロパティは、 メソッドが Refresh() 呼び出されるたびに初期化されます。