ULConnectionStringBuilder-Klasse

Erstellt eine Verbindungszeichenfolge zum Öffnen einer Verbindung zu einer UltraLite-Datenbank.

Visual Basic-Syntax

Public NotInheritable Class ULConnectionStringBuilder
    Inherits System.Data.Common.DbConnectionStringBuilder

C#-Syntax

public sealed class ULConnectionStringBuilder : 
    System.Data.Common.DbConnectionStringBuilder

Mitglieder

Alle Mitglieder der Klasse ULConnectionStringBuilder, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
ULConnectionStringBuilder-Konstruktor	Initialisiert ein ULConnectionStringBuilder-Objekt mit dessen Standardwerten.
Add-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Fügt dem System.Data.Common.DbConnectionStringBuilder-Objekt einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu.
AppendKeyValuePair-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Stellt eine effiziente und sichere Möglichkeit dar, einen Schlüssel und Wert an ein vorhandenes System.Text.StringBuilder-Objekt anzuhängen.
Clear-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Löscht den Inhalt der System.Data.Common.DbConnectionStringBuilder-Instanz.
ClearPropertyDescriptors-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Löscht die Sammlung von System.ComponentModel.PropertyDescriptor-Objekte auf dem verknüpften System.Data.Common.DbConnectionStringBuilder-Objekt.
ContainsKey-Methode	Ermittelt, ob das ULConnectionStringBuilder-Objekt ein spezifisches Schlüsselwort enthält.
EquivalentTo-Methode	Vergleicht die Verbindungsinformationen in diesem ULConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen DbConnectionStringBuilder-Objekt.
GetProperties-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Füllt ein angegebenes System.Collections.Hashtable-Objekt mit Informationen zu allen Eigenschaften dieses System.Data.Common.DbConnectionStringBuilder-Objekts.
GetShortName-Methode	Ruft die kurze Version des angegebenen Schlüsselworts ab.
Remove-Methode	Löscht den Eintrag mit dem angegebenen Schlüssel aus dem ULConnectionStringBuilder-Objekt.
ShouldSerialize-Methode (Geerbt von System.Data.Common.DbConnectionStringBuilder)	Gibt an, ob der angegebene Schlüssel in dieser System.Data.Common.DbConnectionStringBuilder-Instanz existiert.
ToString-Methode (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Gibt die Verbindungszeichenfolge zurück, die diesem System.Data.Common.DbConnectionStringBuilder-Objekt zugeordnet ist.
TryGetValue-Methode	Ruft einen Wert ab, der dem angegebenen Schlüssel aus diesem ULConnectionStringBuilder-Objekt entspricht.
BrowsableConnectionString-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft einen Wert ab, der angibt, ob das System.Data.Common.DbConnectionStringBuilder.ConnectionString-Objekt in den Visual Studio-Designern sichtbar ist, bzw. legt ihn fest.
CacheSize-Eigenschaft	UL-Erw.: Legt die Größe des Caches fest.
ConnectionName-Eigenschaft	Legt einen Namen für die Verbindung fest.
ConnectionString-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft die Verbindungszeichenfolge ab, die dem DbConnectionStringBuilder-Objekt zugeordnet ist, bzw. legt sie fest.
Count-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft die aktuelle Anzahl von Schlüsseln ab, die in der System.Data.Common.DbConnectionStringBuilder.ConnectionString-Eigenschaft enthalten sind.
DatabaseKey-Eigenschaft	Legt einen Schlüssel für die Verschlüsselung der Datenbank fest
DatabaseName-Eigenschaft	Gibt einen Namen für die Datenbank oder einen Namen einer geladenen Datenbank an, mit der eine Verbindung hergestellt werden muss.
DatabaseOnDesktop-Eigenschaft	UL-Erw.: Legt den Pfad und den Dateinamen der UltraLite-Datenbank auf Windows PC-Plattformen fest.
DatabaseOnDevice-Eigenschaft	UL-Erw.: Legt den Pfad und den Dateinamen für die UltraLite-Datenbank unter Windows Mobile fest.
IsFixedSize-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft einen Wert ab, der angibt, ob das System.Data.Common.DbConnectionStringBuilder-Objekt eine feste Größe hat.
IsReadOnly-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft einen Wert ab, der angibt, ob das System.Data.Common.DbConnectionStringBuilder-Objekt schreibgeschützt ist.
Keys-Eigenschaft (Geerbt von System.Data.Common.DbConnectionStringBuilder)	Ruft ein System.Collections.ICollection-Objekt ab, das die Schlüssel aus dem System.Data.Common.DbConnectionStringBuilder-Objekt enthält.
OrderedTableScans-Eigenschaft	Legt fest, ob SQL-Abfragen ohne ORDER BY-Klauseln standardmäßig geordnete Table-Scans durchführen sollen.
Password-Eigenschaft	Gibt das Kennwort für den authentifizierten Benutzer an.
ReserveSize-Eigenschaft	UL-Erw.: Gibt den Reservierungsspeicherplatz des Dateisystems zur Speicherung von beständigen UltraLite-Daten an.
StartLine-Eigenschaft	Gibt den Speicherort an und startet dann die UltraLite-Engine.
this-Eigenschaft	Gibt den Wert des angegebenen Verbindungsschlüsselworts an.
UserID-Eigenschaft	Legt einen authentifizierten Benutzer für die Datenbank fest.
Values-Eigenschaft (geerbt aus System.Data.Common.DbConnectionStringBuilder)	Ruft ein System.Collections.ICollection-Objekt ab, das die Werte aus dem System.Data.Common.DbConnectionStringBuilder-Objekt enthält.

Bemerkungen

Die häufig verwendeten Verbindungszeichenfolgen sind individuelle Eigenschaften des Objekts ULConnectionStringBuilder.

Die ULConnectionStringBuilder-Klasse ist in .NET Compact Framework 2.0 nicht verfügbar.

Mit einem ULConnectionStringBuilder-Objekt werden die Parameter zum Öffnen einer Verbindung (mit der ULConnection.Open-Methode) oder zum Löschen einer Datenbank (mit der ULDatabaseManager.DropDatabase-Methode) 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 geeigneten Eigenschaften für ein ULConnectionStringBuilder-Objekt angegeben haben, können Sie mit System.Data.Common.DbConnectionStringBuilder.ConnectionString eine Verbindungszeichenfolge erstellen. Die resultierende Zeichenfolge wird verwendet, um ein neues ULConnection-Objekt mit dem ULConnection(String)-Konstruktor zu erstellen oder die ULConnection.ConnectionString-Eigenschaft für ein vorhandenes ULConnection-Objekt festzulegen.

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.DatabaseOnDevice = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

Dies entspricht dem folgenden Code in der Sprache C#:

// C#
ULConnectionStringBuilder dbName = new ULConnectionStringBuilder();
dbName.DatabaseOnDevice = "\\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.

Optionale Verbindungseinstellungen

Abhängig von den Anforderungen Ihrer Anwendung und davon, wie die Datenbank erstellt wurde, müssen Sie möglicherweise einen vom Standardwert abweichenden ULConnectionStringBuilder.UserID-Wert, einen vom Standardwert abweichenden ULConnectionStringBuilder.Password-Wert, einen ULConnectionStringBuilder.DatabaseKey-Wert für die Datenbank und den ULConnectionStringBuilder.CacheSize-Wert angeben. Wenn Ihre Anwendung mehrere Verbindungen verwendet, müssen Sie für jede Verbindung einen eindeutigen ULConnectionStringBuilder.ConnectionName-Wert 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. Um den Standardbenutzer zu deaktivieren, verwenden Sie die ULConnection.RevokeConnectFrom-Methode. Um einen Benutzer hinzuzufügen oder das Kennwort für einen Benutzer zu ändern, verwenden Sie die ULConnection.GrantConnectTo-Methode.

Wenn bei der Erstellung der Datenbank ein Chiffrierschlüssel angegeben wurde, müssen alle nachfolgenden Verbindungen mit der Datenbank denselben Chiffrierschlüssel verwenden. Um den Chiffrierschlüssel einer Datenbank ändern, verwenden Sie die ULConnection.ChangeEncryptionKey-Methode.

Siehe auch

ULConnectionStringBuilder-Konstruktor
ContainsKey-Methode
EquivalentTo-Methode
GetShortName-Methode
Remove-Methode
TryGetValue-Methode
CacheSize-Eigenschaft
ConnectionName-Eigenschaft
DatabaseKey-Eigenschaft
DatabaseName-Eigenschaft
DatabaseOnDesktop-Eigenschaft
DatabaseOnDevice-Eigenschaft
OrderedTableScans-Eigenschaft
Password-Eigenschaft
ReserveSize-Eigenschaft
StartLine-Eigenschaft
this-Eigenschaft
UserID-Eigenschaft

Kommentieren Sie diese Seite in DocCommentXchange.