使用指定的连接信息创建 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。