ConnectionString プロパティ (ADO)
データ ソースへの接続を確立するために使用される情報を示します。
設定と戻り値
文字列 値を設定または返します。
備考
ConnectionString プロパティを使用して、セミコロンで区切られた一連の 引数= value ステートメントを含む詳細な接続文字列を渡すことによって、データ ソースを指定します。
ADO では、ConnectionString プロパティに対して 5 つの引数がサポートされています。その他の引数は、ADO による処理なしでプロバイダーに直接渡されます。 ADO でサポートされる引数は次のとおりです。
引数 | 形容 |
---|---|
Provider= | 接続に使用するプロバイダーの名前を指定します。 |
ファイル名 = | 事前設定された接続情報を含むプロバイダー固有のファイル (永続化されたデータ ソース オブジェクトなど) の名前を指定します。 |
リモート プロバイダー= | クライアント側接続を開くときに使用するプロバイダーの名前を指定します。 (リモート データ サービスのみ)。) |
リモート サーバー= | クライアント側接続を開くときに使用するサーバーのパス名を指定します。 (リモート データ サービスのみ)。) |
URL= | ファイルやディレクトリなどのリソースを識別する絶対 URL として接続文字列を指定します。 |
ConnectionString プロパティを設定し、Connection オブジェクトを開くと、たとえば、ADO で定義された引数名を特定のプロバイダーに対応する名前にマッピングすることによって、プロバイダーはプロパティの内容を変更できます。
ConnectionString プロパティは、Open メソッドの ConnectionString 引数に使用される値を自動的に継承するため、Open メソッドの呼び出し中に現在の ConnectionString プロパティをオーバーライドできます。
ファイル名 引数を指定すると、ADO は関連付けられたプロバイダーを読み込むため、プロバイダー 引数と ファイル名 引数の両方を渡すことはできません。
ConnectionString プロパティは、接続が閉じられている場合は読み取り/書き込みであり、開いている場合は読み取り専用です。
ConnectionString プロパティの引数の重複は無視されます。 引数の最後のインスタンスが使用されます。
手記
Remote Data Service Usage クライアント側の Connection オブジェクトで使用する場合、ConnectionString プロパティには、リモート プロバイダー とリモート サーバー パラメーターのみを含めることができます。
次の表に、各 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 は次のエラーを返します。接続: プロバイダーが指定されておらず、既定のプロバイダーが指定されていません" |
Windows 2000 (64 ビット) Windows XP (64 ビット) Windows 2003 Server (64 ビット) Windows Vista (64 ビット) |
適用対象
関連項目
ConnectionString、ConnectionTimeout、State プロパティの使用例 (VB)
ConnectionString、ConnectionTimeout、および State プロパティの使用例 (VC++)
付録 A: プロバイダー