Freigeben über


IVsDataConnectionFactory.CreateConnection-Methode

Initialisiert eine neue Instanz der IVsDataConnection-Klasse mit den angegebenen Verbindungsinformationen.

Namespace:  Microsoft.VisualStudio.Data.Services
Assembly:  Microsoft.VisualStudio.Data.Services (in Microsoft.VisualStudio.Data.Services.dll)

Syntax

'Declaration
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

Parameter

  • provider
    Typ: Guid

    Der eindeutige Bezeichner eines DDEX-Anbieters.

  • connectionString
    Typ: String

    Eine unverschlüsselte oder verschlüsselte Zeichenfolge, die Verbindungsinformationen enthält.

  • encryptedString
    Typ: Boolean

    Gibt an, ob der Parameter connectionString unverschlüsselt oder verschlüsselt ist. Geben Sie true an, wenn Sie verschlüsselt werden.

Rückgabewert

Typ: Microsoft.VisualStudio.Data.Services.IVsDataConnection
Ein IVsDataConnection-Objekt, das eine Datenverbindung darstellt.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Der cconnectionString-Parameter ist nullein Nullverweis (Nothing in Visual Basic).

ArgumentException

provider ist kein registrierter DDEX-Anbieter.

Hinweise

Der Aufrufer ist der exklusive Besitzer der zurückgegebenen Datenverbindungsinstanz, und es ist daher die Verantwortung des Aufrufers, die Dispose-Methode der Verbindung aufzurufen, um seine Ressourcen effektiv zu verwalten.

Hinweis

Andere Ausnahmen, die auftreten, geben einen anbieterspezifischen Fehler bei der Initialisierung des AnbieterVerbindungsobjekts an.

.NET Framework-Sicherheit

Siehe auch

Referenz

IVsDataConnectionFactory Schnittstelle

Microsoft.VisualStudio.Data.Services-Namespace