ULConnectionParms-Klasse

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

Visual Basic-Syntax

Public Class ULConnectionParms Inherits System.ComponentModel.Component

C#-Syntax

public class ULConnectionParms : System.ComponentModel.Component

Mitglieder

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

Name	Beschreibung
ULConnectionParms-Konstruktor	Initialisiert eine ULConnectionParms-Instanz mit ihren Standardwerten.
Dispose-Methode (Geerbt von System.ComponentModel.Component)	Gibt alle Ressourcen frei, die von der System.ComponentModel.Component verwendet werden.
Finalize-Methode (Geerbt von System.ComponentModel.Component)	Gibt unverwaltete Ressourcen frei und führt andere Aufräumvorgänge aus, bevor die System.ComponentModel.Component von der Garbage Collection bereinigt wird.
GetService-Methode (Geerbt von System.ComponentModel.Component)	Gibt ein Objekt zurück, das für einen Dienst steht, der von der System.ComponentModel.Component oder ihrem System.ComponentModel.Container bereitgestellt wird.
ToString-Methode	Gibt die Zeichenfolge zurück, die diese Instanz repräsentiert.
AdditionalParms-Eigenschaft	Legt zusätzliche Parameter als semikolongetrennte Liste von Paaren der Form Name=Wert fest.
CacheSize-Eigenschaft	Legt die Größe des Caches fest.
CanRaiseEvents-Eigenschaft (Geerbt von System.ComponentModel.Component)	Ruft einen Wert ab, der anzeigt, ob die Komponente ein Ereignis auslösen kann.
ConnectionName-Eigenschaft	Legt einen Namen für die Verbindung fest.
Container-Eigenschaft (Geerbt von System.ComponentModel.Component)	Ruft den System.ComponentModel.IContainer ab, der die System.ComponentModel.Component enthält.
DatabaseOnDesktop-Eigenschaft	Legt den Pfad und den Dateinamen der UltraLite-Datenbank auf Windows PC-Plattformen fest.
DatabaseOnDevice-Eigenschaft	Legt den Pfad und den Dateinamen für die UltraLite-Datenbank unter Windows Mobile fest.
DesignMode-Eigenschaft (Geerbt von System.ComponentModel.Component)	Ruft einen Wert ab, der angibt, ob System.ComponentModel.Component derzeit im Planungsmodus ist.
EncryptionKey-Eigenschaft	Legt einen Schlüssel für die Verschlüsselung der Datenbank fest
Disposed (Geerbt von System.ComponentModel.Component) Bezieht die Liste der Event-Handler, die dieser System.ComponentModel.Component angefügt wurden. Events-Eigenschaft (Geerbt von System.ComponentModel.Component)	Erscheint, wenn die Komponente durch einen Aufruf der System.ComponentModel.Component.Dispose-Methode gelöscht wird.
Password-Eigenschaft	Gibt das Kennwort für den authentifizierten Benutzer an.
Site-Eigenschaft (Geerbt von System.ComponentModel.Component)	Ruft das System.ComponentModel.ISite-Objekt der System.ComponentModel.Component ab bzw. legt es fest.
UserID-Eigenschaft	Legt einen authentifizierten Benutzer für die Datenbank fest.

Bemerkungen

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

Mit einem ULConnectionParms-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 ULConnectionParms-Objekt angegeben haben, können Sie mit der ULConnectionParms.ToString-Methode 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 ULConnectionParms = new ULConnectionParms
dbName.DatabaseOnDevice = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

Dies entspricht dem folgenden Code in der Sprache C#:

// C#
ULConnectionParms dbName = new ULConnectionParms();
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 ULConnectionParms.UserID-Wert, einen vom Standardwert abweichenden ULConnectionParms.Password-Wert, einen ULConnectionParms.EncryptionKey-Wert für die Datenbank und den ULConnectionParms.CacheSize-Wert angeben. Wenn Ihre Anwendung mehrere Verbindungen verwendet, müssen Sie für jede Verbindung einen eindeutigen ULConnectionParms.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

ULConnectionParms-Konstruktor
ToString-Methode
AdditionalParms-Eigenschaft
CacheSize-Eigenschaft
ConnectionName-Eigenschaft
DatabaseOnDesktop-Eigenschaft
DatabaseOnDevice-Eigenschaft
EncryptionKey-Eigenschaft
Password-Eigenschaft
UserID-Eigenschaft

Kommentieren Sie diese Seite in DocCommentXchange.