UL-Erw.: Erstellt eine Verbindungszeichenfolge zum Öffnen einer Verbindung zu einer UltraLite-Datenbank. Die häufig verwendeten Verbindungszeichenfolgen sind individuelle Eigenschaften des Objekts ULConnectionParms.

Syntax

Visual Basic
Public Class ULConnectionParms
  Inherits Component

C#
public class ULConnectionParms: Component

Bemerkungen

Mit einem ULConnectionParms-Objekt werden die Parameter zum Öffnen einer Verbindung (ULConnection.Open) oder zum Löschen einer Datenbank (ULDatabaseManager.DropDatabase) angegeben.

Führende und nachgestellte Leerzeichen werden in allen Werten ignoriert. Werte dürfen keine führenden oder nachgestellten Leerzeichen oder ein Semikolon (;) enthalten oder mit einem Apostroph (') oder Anführungszeichen (") beginnen.

Beim Erstellen einer Verbindungszeichenfolge müssen Sie die Datenbank angeben und alle optionalen Verbindungseinstellungen festlegen. Wenn Sie alle Verbindungsparameter durch Festlegen der zutreffenden Eigenschaften für ein ULConnectionParms-Objekt bereitgestellt haben, erstellen Sie mit ULConnectionParms.ToString eine Verbindungszeichenfolge. Mit der resultierenden Zeichenfolge wird ein neues ULConnection-Objekt mit dem ULConnection(String)-Konstruktor erstellt bzw. ein ULConnection.ConnectionString-Objekt für ein vorhandenes ULConnection-Objekt festgelegt.

Datenbank identifizieren

Jede Instanz enthält plattformspezifische Pfade zu der Datenbank. Es wird nur der Wert für die ausführende Plattform verwendet. Im folgenden Code wird der Pfad \UltraLite\mydb1.udb unter Windows Mobile verwendet, während mydb2.udb auf anderen Plattformen verwendet wird.

' Visual Basic
Dim dbName As ULConnectionParms = new ULConnectionParms
dbName.DatabaseOnCE = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

// C#
ULConnectionParms dbName = new ULConnectionParms();
dbName.DatabaseOnCE = "\\UltraLite\\mydb1.udb";
dbName.DatabaseOnDesktop = @"somedir\mydb2.udb";

Die empfohlene Erweiterung für UltraLite-Datenbankdateien ist .udb. Auf Windows Mobile-Geräten ist die Standarddatenbank \UltraLiteDB\ulstore.udb. Auf anderen Windows-Plattformen ist die Standarddatenbank ulstore.udb. In C# muss jedem Backslashzeichen in einem Pfad ein Escapezeichen vorangestellt oder eine von @-Zeichen umschlossene Literal-Zeichenfolge verwendet werden.

Bei der Verwendung mehrerer Datenbanken muss für jede Datenbank ein Datenbankname angegeben werden. Weitere Hinweise finden Sie unter AdditionalParms-Eigenschaft.

Optionale Verbindungseinstellungen

Abhängig von den Anforderungen Ihrer Anwendung und davon, wie die Datenbank erstellt wurde, müssen Sie möglicherweise ein vom Standardwert abweichendes ULConnectionParms.UserID- und ULConnectionParms.Password-Objekt, ein ULConnectionParms.EncryptionKey-Objekt für eine Datenbank und das ULConnectionParms.CacheSize-Objekt für die Verbindung angeben. Wenn Ihre Anwendung mehrere Verbindungen verwendet, sollten Sie für jede Verbindung ein eindeutiges ULConnectionParms.ConnectionName-Objekt angeben.

Datenbanken werden mit der einfach authentifizierten Benutzer-ID DBA und dem anfänglichen Kennwort sql erstellt. Standardmäßig werden die Verbindungen mit der Benutzer-ID DBA und dem Kennwort sql geöffnet. Mit ULConnection.RevokeConnectFrom können Sie den Standard-Benutzer deaktivieren. Mit ULConnection.GrantConnectTo können Sie einen Benutzer hinzufügen oder das Kennwort eines Benutzers ändern.

Wenn bei der Erstellung der Datenbank ein Chiffrierschlüssel angegeben wurde, müssen alle nachfolgenden Verbindungen mit der Datenbank denselben Chiffrierschlüssel verwenden. Mit ULConnection.ChangeEncryptionKey können Sie den Chiffrierschlüssel einer Datenbank ändern.

Weitere Hinweise finden Sie unter UltraLite-Verbindungsparameter.

Siehe auch

• ULConnectionParms-Mitglieder
• Open-Methode
• DropDatabase-Methode
• ToString-Methode
• ULConnection-Klasse
• ULConnection(String)-Konstruktor
• ConnectionString-Eigenschaft
• UserID-Eigenschaft
• Password-Eigenschaft
• EncryptionKey-Eigenschaft
• CacheSize-Eigenschaft
• ConnectionName-Eigenschaft
• RevokeConnectFrom-Methode
• GrantConnectTo-Methode
• ChangeEncryptionKey-Methode