Die VDF-Verbindung ist einer der wichtigsten Zugriffspunkte auf die von VDF bereitgestellten Services.
Eine VDF-Verbindung wird durch eine Instanz der Klasse VDF.Vault.Currency.Connection.Connection dargestellt. Um ein VDF Connection-Objekt zu erhalten, muss sich die Client-Anwendung beim Vault-Server anmelden. VDF bietet sowohl eine grafisch orientierte als auch eine nicht grafisch orientierte programmatische Anmeldemethode, die entweder ein Ergebnisobjekt mit der neu erstellten VDF-Verbindung oder das Verbindungsobjekt selbst zurückgibt.
Zur Ausführung einer grafisch orientierten Anmeldung muss die Client-Anwendung die Methode VDF.Vault.Forms.Library.Login() aufrufen. Diese Methode verwendet das Objekt VDF.Vault.Forms.Settings.LoginSettings, mit der der Client das Verhalten der Anmeldung bei VDF anpassen kann. Bei der grafisch orientierten Anmeldung wird ein Dialogfeld angezeigt, in dem der Benutzer seine Anmeldeinformationen eingibt, der Anmeldeverlauf angezeigt wird, die Anmeldedaten des Benutzers gespeichert werden können usw. Diese grafisch orientierte Anmeldemethode wird in den im Vault SDK enthaltenen Beispielanwendungen näher illustriert (z. B. in der Beispielanwendung VaultFileBrowser).
Bei der nicht grafisch orientierten Anmeldung stellt die Client-Anwendung die Anmeldedaten ohne Benutzerabfrage direkt für VDF bereit. Die nicht grafisch orientierte Anmeldung erfolgt über die Methode VDF.Vault.Library.ConnectionManager.Login(). Weitere Informationen zu beiden Anmeldemethoden und deren Einstellungen bzw. Parametern finden Sie in der Dokumentation zum SDK. Sobald Sie über eine VDF-Verbindung verfügen, können die Client-Anwendungen diese verwenden, um über Services wie den Dateimanager mit dem Vault-Server zu interagieren, oder indem sie das Verbindungsobjekt Bibliotheksmethoden zur Verfügung stellen, die eine Verbindung benötigen.
Migration vom WebServiceManager des Vault 2013-SDK zur VDF Connection-Klasse
Die Klasse VDF Connection ermöglicht Zugriff auf eine WebServiceManager-Instanz, die die gleiche Vault-Serververbindung verwendet. Die Transformation von vorhandenem Code, der mit der Methode WebServiceManager des 2013-SDK erstellt wurde, zur VDF Connection-Klasse sollte daher problemlos erfolgen. Es müssen lediglich die Verweise auf eine WebServiceManager-Instanz durch Aufrufe der WebServiceManager-Eigenschaft einer aktiven VDF Connection-Instanz ersetzt werden. Einzig die Art, wie die Client-Anwendung eine Verbindung abruft, unterscheidet sich nun noch. Wie bereits erwähnt, rufen Client-Anwendungen ein VDF Connection-Objekt über eine der beiden Anmeldemethoden ab. Bei Client-Anwendungen, für die nur geringfügige Änderungen vorgenommen werden sollen, kommen die Zuordnungen für die nicht grafisch orientierte Anmeldung bei VDF schon recht nahe an den WebServiceManager-Konstruktor heran. Die Client-Anwendungen können daher einfach die Erstellung eines WebServiceManager durch eine VDF-Anmeldung austauschen. So erstellen zum Beispiel die folgenden beiden Code-Snippets im Wesentlichen die gleiche Vault-Verbindung:
Mit WebServiceManager (C#):
Mit VDF-Anmeldung (C#):
Wenn eine Vault-Verbindung aufgebaut wird, muss natürlich auch bedacht werden, wie sich die Client-Anwendung wieder von dieser Verbindung abmeldet bzw. wie sie diese beendet. Während WebServiceManager ein IDisposable war, ist VDF Connection dies nicht. Es wird daher empfohlen, die Vault-Verbindung durch Übergabe der VDF-Verbindung, von der Sie sich abmelden wollen, an die ConnectionManager-Methode Logout() freizugeben.