Método IVsDataConnectionFactory.CreateConnection
Inicializa uma nova instância da classe de IVsDataConnection com informações de conexão especificada.
Namespace: Microsoft.VisualStudio.Data.Services
Assembly: Microsoft.VisualStudio.Data.Services (em Microsoft.VisualStudio.Data.Services.dll)
Sintaxe
'Declaração
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
Parâmetros
provider
Tipo: Guido identificador exclusivo de um provedor de DDEX.
connectionString
Tipo: StringUma cadeia de caracteres não criptografado ou criptografado contendo informações de conexão.
encryptedString
Tipo: BooleanIndica se o parâmetro de connectionString não é criptografado ou criptografado. Especifique se true criptografado.
Valor de retorno
Tipo: Microsoft.VisualStudio.Data.Services.IVsDataConnection
Um objeto de IVsDataConnection que representa uma conexão de dados.
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | o parâmetro de cconnectionString é nulluma referência nula (Nothing no Visual Basic). |
ArgumentException | provider não é registrado um provedor de DDEX. |
Comentários
O chamador será o proprietário de instância única retornado da conexão de dados, e portanto é responsabilidade do chamador chamar o método de Dispose conexão na verdade para gerenciar seus recursos.
Dica
Outras exceções que ocorrem indicam um erro específico do provedor durante a inicialização de objeto de conexão do provedor.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.