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