ConnectionString プロパティ (ADO)
適用先: Access 2013、Office 2013
データ ソースとの接続を確立するために使用される情報を示します。
設定と戻り値
文字列型 (String) の値を設定または取得します。
注釈
ConnectionString プロパティを使用して、セミコロンで区切られた一連の argument= value ステートメントを含む詳細な接続文字列を渡すことで、データ ソースを指定します。
ADO では、 ConnectionString プロパティに対して 5 つの引数がサポートされています。その他の引数は、ADO による処理なしでプロバイダーに直接渡されます。 ADO でサポートされる引数は次のとおりです。
主張 |
説明 |
---|---|
Provider= |
接続に使用するプロバイダーの名前を指定します。 |
File Name= |
設定済みの接続情報を格納したプロバイダー固有のファイル (たとえば、持続的なデータ ソース オブジェクト) の名前を指定します。 |
Remote Provider= |
クライアント側接続を開くときに使用するプロバイダーの名前を指定します。 (リモート データ サービスのみ)。 |
Remote Server= |
クライアント側接続を開くときに使用するサーバーのパス名を指定します。 (リモート データ サービスのみ)。 |
URL= |
接続文字列を、ファイルやディレクトリなどのリソースを識別する絶対 URL として指定します。 |
ConnectionString プロパティを設定して Connection オブジェクトを開いた後、ADO によって定義された引数名がプロバイダーの対応する引数名にマップされるなど、プロバイダーによってプロパティの内容が変更される場合があります。
ConnectionString プロパティは、Open メソッドの ConnectionString 引数に使用された値を自動的に継承します。したがって、Open メソッドの呼び出し中に現在の ConnectionString プロパティを上書きできます。
File Name 引数により関連のあるプロバイダーが呼び出されるため、Provider 引数と File Name 引数の両方を渡すことはできません。
ConnectionString プロパティは、接続が閉じているときは読み取り/書き込み可能で、開いているときは読み取り専用になります。
ConnectionString プロパティにおいて重複している引数は無視されます。 引数の最後のインスタンスが使用されます。
リモート データ サービスの使用状況クライアント側 の Connection オブジェクトで使用する場合、 ConnectionString プロパティには 、リモート プロバイダー パラメーターと リモート サーバー パラメーターのみを含めることができます。