Diese Klasse stellt eine Verbindung zu einer beliebigen Datenquelle her. Weiterhin kann eine einfache Verbindung zu den ZS-Mail Datenbanken hergestellt werden. Die Verbindung ist sowohl per ADO als auch per DAO möglich. Die Verbindung zur Datenquelle ist explizit (eine Verbindung).

Allgemeine Eigenschaften der Klasse:

bADO|Datentyp Boolean

Hinterlegt ob über ADO zugegriffen werden soll.

Yes = True

No = False

bServer|Datentyp Boolean

Hinterlegt ob auf die Serverdatenbank von ZS-Mail zugegriffen werden soll.

Yes = True

No = False (auf die Clientdatenbank von ZS-Mail wird zugegriffen)

bZS_Mail|Datentyp Boolean

Hinterlegt ob eine ZS-Mail Datenbank genutzt werden soll.

Yes = True

No = False (eine andere Datenquelle kann genutzt werden)

sLocDBPath|Datentyp String

Hier wird der Pfad der Clientdatenbank von ZS-Mail hinterlegt, wenn auf die ZS-Mail Clientdatenbank zugegriffen werden soll. (Ab der finalen Version von ZS-Mail nicht mehr nötig).

Eigenschaften bei dem ADO-Zugriff:

sAData_Source|Datentyp String

Legt den Namen einer Datenquelle für die Verbindung fest, z.B. eine SQL-Server-Datenbank, die als ODBC-Datenquelle registriert ist.

sAInitial_Catalog|Datentyp String

Legt den Namen einer providerspezifischen Datei fest (z.B. ein ständiges Datenquellenobjekt), die die voreingestellten Verbindungsinformationen enthält.

sAProvider|Datentyp String

Legt den Namen eines Providers fest, der für die Verbindung verwendet wird.

sAPWD|Datentyp String

Legt das anzuwendende Kennwort beim Öffnen der Verbindung fest.

sAUID|Datentyp String

Legt den zu verwendenden Anwendernamen beim Öffnen der Verbindung fest.

Eigenschaften bei dem DAO-Zugriff:

bDReadOnly|Datentyp Boolean

Legt fest, ob die Datenbank nur gelesen werden kann.

Yes = True

No = False (es kann in die Datenbank geschrieben werden)

sDConnect|Datentyp String

Legt verschiedene Verbindungsoptionen (z. B. Kennwort) fest.

sDName|Datentyp String

Legt den Pfad und den Namen der Datenbank fest.

vDOptions|Datentyp Variant

Legt verschiedene Optionen fest. Hier können folgende Konstanten genutzt werden.

JetExclusiv = Datenbank wird exclusiv geöffnet.

JetNotExclusiv = Datenbank kann auch von anderen Benutzern geöffnet werden.

ODBCDriverNoPrompt = Die ODBC-Treiber-Manager verwendet die Verbindungszeichenfolge, die in DBName und Verbindung bereitgestellt wird. Stellen Sie nicht ausreichende Informationen bereit, tritt ein Laufzeitfehler auf.

ODBCDriverPrompt = Die ODBC-Treiberverwaltung zeigt das Dialogfeld ODBC-Datenquelle an, in dem alle in DBName oder Verbindung befindlichen relevanten Informationen angezeigt werden. Die Verbindungszeichenfolge wurde aus dem Datenquellennamen gebildet, den der Benutzer über die Dialogfelder ausgewählt hat, bzw. falls der Benutzer keinen Datenquellennamen bestimmt hat, wird der voreingestellte Datenquellenname verwendet.

ODBCDriverComplete = (Voreinstellung) Wenn die Argumente Verbindung und DBName alle zur Herstellung einer Verbindung benötigten Informationen enthalten, verwendet die ODBC-Treiberverwaltung die Zeichenfolge in Verbindung. Andernfalls verhält sie sich, als wenn Sie dbDriverPrompt angäben.

ODBCDriverCompleteRequired = Diese Option verhält sich wie dbDriverComplete, mit der Ausnahme, daß der ODBC-Treiber die Aufforderung nach Informationen, die für die Herstellung der Verbindung nicht erforderlich sind, deaktiviert.

Methoden der Klasse:

Connect

Baut eine Verbindung zur Datenquelle auf. Die Art und Weise der Verbindung wird über die Eigenschaften gesteuert. Die API hält anschließend die Verbindung, und kann weitere "Aktionen" mit der Quelle ausführen.

Beispiele (Visual Basic):

In den folgenden Beispielen ist zu beachten, das ein Verweis auf die ZS-MAPI vorgenommen wurde.

Verbindung auf die Serverdatenbank von ZS-Mail per DAO:

Hier eine Verbindung zu dem Excelsheet "Umsatz" per ADO: