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 (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.

Identifying the database

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.

Optional connection settings

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-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.