指定した接続情報を含む IVsDataConnection クラスの新しいインスタンスを初期化します。
名前空間: Microsoft.VisualStudio.Data.Services
アセンブリ: Microsoft.VisualStudio.Data.Services (Microsoft.VisualStudio.Data.Services.dll 内)
構文
'宣言
Function CreateConnection ( _
provider As Guid, _
connectionString As String, _
encryptedString As Boolean _
) As IVsDataConnection
IVsDataConnection CreateConnection(
Guid provider,
string connectionString,
bool encryptedString
)
IVsDataConnection^ CreateConnection(
Guid provider,
String^ connectionString,
bool encryptedString
)
abstract CreateConnection :
provider:Guid *
connectionString:string *
encryptedString:bool -> IVsDataConnection
function CreateConnection(
provider : Guid,
connectionString : String,
encryptedString : boolean
) : IVsDataConnection
パラメーター
- provider
型 : System.Guid
DDEX プロバイダーの一意の識別子。
- connectionString
型 : System.String
接続情報を含む暗号化または暗号化された文字列。
- encryptedString
型 : System.Boolean
connectionString のパラメーターを暗号化または暗号化するかどうかを示します。暗号化された true を指定します。
戻り値
型 : Microsoft.VisualStudio.Data.Services.IVsDataConnection
データ接続を表す IVsDataConnection のオブジェクト。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | cconnectionString パラメーターが nullnull 参照 (Visual Basic では Nothing) です。 |
| ArgumentException | provider、登録された DDEX プロバイダーではありません。 |
解説
呼び出し元は、返されたデータ接続のインスタンスの排他的所有者になり、その結果、効果的にリソースを管理する接続の Dispose のメソッドを呼び出す呼び出し元が保証します。
[!メモ]
例外は、ほかのプロバイダーの接続オブジェクトの初期化中に、プロバイダー固有のエラーを示します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。