DataConnectionFactory.CreateDataConnection 方法

使用指定的连接信息创建 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 安全性

请参见

参考

DataConnectionFactory 类

Microsoft.VisualStudio.Data 命名空间