ConnectionString プロパティ (ADO)

データソースへの接続の確立に使用される情報を示します。

設定と戻り値

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 引数を指定すると、ADO によって関連するプロバイダーが読み込まれるため、Provider と File Name の両方の引数を渡すことはできません。

ConnectionString プロパティは、接続が閉じている場合は読み取り/書き込みであり、開いている場合は読み取り専用です。

ConnectionString プロパティ内の引数の重複は無視されます。引数の最後のインスタンスが使用されます。

注意

リモートデータサービスの使用 クライアント側の Connection オブジェクトで使用する場合、ConnectionString プロパティには、Remote Provider と Remote Server のパラメーターのみを含めることができます。

次の表に、各 Windows オペレーティングシステムの既定の ADO プロバイダーを示します。

既定の ADO プロバイダー	Windows オペレーティングシステム
MSDASQL (ソースコードの読みやすさを向上させるために、接続文字列でプロバイダー名を明示的に指定します)。	Windows 2000 (32 ビット) Windows XP (32 ビット) Windows 2003 Server (32 ビット) Windows Vista (32 ビット) Windows Vista Service Pack 1 以降 (32 ビットおよび 64 ビット) Windows Vista 以降の Windows バージョン (32 ビットおよび 64 ビット)
既定値はありません。 ADO アプリケーションが次のオペレーティングシステムで実行され、プロバイダーを明示的に指定しない場合、ADO は "ADODB.Connection: プロバイダーが指定されておらず、既定のプロバイダーがありません" というエラーを返します。	Windows 2000 (64 ビット) Windows XP (64 ビット) Windows 2003 Server (64 ビット) Windows Vista (64 ビット)