Erstellt eine Verbindungszeichenfolge zum Öffnen einer Verbindung zu einer UltraLite-Datenbank. Die häufig verwendeten Verbindungszeichenfolgen sind individuelle Eigenschaften des Objekts ULConnectionStringBuilder. Diese Klasse kann nicht geerbt werden.

Syntax

Visual Basic
Public NotInheritable Class ULConnectionStringBuilder
  Inherits DbConnectionStringBuilder

C#
public sealed class ULConnectionStringBuilder: DbConnectionstring Builder

Bemerkungen

Einschränkungen: Die ULConnectionStringBuilder-Klasse ist in .NET Compact Framework 2.0 nicht verfügbar.

Mit einem ULConnectionStringBuilder-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 ULConnectionStringBuilder-Objekt bereitgestellt haben, erstellen Sie mit System.Data.Common.DbConnectionStringBuilder.ConnectionString 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 ULConnectionStringBuilder = _
  new ULConnectionStringBuilder
dbName.DatabaseOnCE = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

// C#
ULConnectionStringBuilder dbName = new ULConnectionStringBuilder();
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 DatabaseName-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 ULConnectionStringBuilder.UserID- und ULConnectionStringBuilder.Password-Objekt, ein ULConnectionStringBuilder.DatabaseKey-Objekt für eine Datenbank und das ULConnectionStringBuilder.CacheSize-Objekt für die Verbindung angeben. Wenn Ihre Anwendung mehrere Verbindungen verwendet, sollten Sie für jede Verbindung ein eindeutiges ULConnectionStringBuilder.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

• ULConnectionStringBuilder-Mitglieder
• Open-Methode
• DropDatabase-Methode
•  DbConnectionStringBuilder.ConnectionString
• ULConnection-Klasse
• ULConnection(String)-Konstruktor
• ConnectionString-Eigenschaft
• DatabaseName-Eigenschaft
• UserID-Eigenschaft
• Password-Eigenschaft
• DatabaseKey-Eigenschaft
• CacheSize-Eigenschaft
• ConnectionName-Eigenschaft
• RevokeConnectFrom-Methode
• GrantConnectTo-Methode
• ChangeEncryptionKey-Methode