AdditionalParms-Eigenschaft

Public Property AdditionalParms As String

public string AdditionalParms {get;set;}

ArgumentException Der Wert enthielt eine ungültige Verbindungszeichenfolge.

Diese Parameter werden seltener verwendet.

Eine durch Semikolons getrennte Liste von zusätzlichen Parametern in der Form Schlüsselwort=Wert-Paaren. Die Werte der Schlüsselwort=Wert-Liste müssen den Regeln für ULConnection.ConnectionString entsprechen. Der Standardwert ist eine Nullreferenz ("Nothing" in Visual Basic).

Die Werte für die Parameter für die Seitengröße und die Größe der Reserve werden in der Einheit Byte angegeben. Verwenden Sie das Suffix k oder K und das Suffix M oder m, um die Einheiten kB bzw. MB anzugeben.

Folgende zusätzliche Parameter sind verfügbar:

Schlüsselwort	Beschreibung
dbn	Kennzeichnet eine geladene Datenbank, mit der eine Verbindung hergestellt werden muss Wenn eine Datenbank auf einem Server gestartet wird, wird ihr ein Datenbankname zugewiesen, und zwar entweder explizit mit der dbn-Option oder von UltraLite unter Verwendung des Dateinamens, wobei Erweiterung und Pfad weggelassen werden. Beim Öffnen von Verbindungen sucht UltraLite zunächst nach einer laufenden Datenbank mit einer übereinstimmenden dbn-Option. Wenn keine gefunden wird, startet UltraLite eine neue Datenbank mit dem geeigneten Datenbank-Dateinamenparameter (DatabaseOnDevice oder DatabaseOnDesktop). Dieser Parameter ist erforderlich, wenn die Anwendung (oder UltraLite-Engine) auf zwei unterschiedliche Datenbanken zugreifen muss, die denselben Basis-Dateinamen haben. Dieser Parameter wird nur verwendet, wenn mit ULConnection.Open eine Verbindung hergestellt wird.
reserve_size	Reserviert Speicher im Dateisystem für die Speicherung von beständigen UltraLite-Daten. Mit dem Parameter reserve_size können Sie den für die UltraLite-Datenbank erforderlichen Speicher im Dateisystem vorab zuweisen, ohne Daten einzufügen. Durch das Reservieren von Speicher im Dateisystem können Sie die Performance geringfügig steigern und Fehler aufgrund von zu wenig Speicherplatz verhindern. Standardmäßig wächst die Datei für den beständigen Speicher nur bei Bedarf, wenn die Anwendung die Datenbank aktualisiert. Beachten Sie, dass reserve_size Speicher im Dateisystem reserviert, wobei auch die Metadaten in der beständigen Speicherdatei einbezogen werden und nicht ausschließlich die unformatierten Daten. Der Metadaten-Overhead und die Datenkomprimierung müssen bei der Ermittlung des erforderlichen Speichers im Dateisystem anhand des Umfangs der Datenbankdaten berücksichtigt werden. Der Parameter reserve_size reserviert Speicher, indem die Datei für den beständigen Speicher beim Start auf die betreffende Reservierungsgröße gebracht wird, und zwar unabhängig von der zuvor vorhandenen Datei. Die Datei wird niemals gekürzt. Die folgende Parameterzeichenfolge stellt sicher, dass die Datei für den beständigen Speicher beim Start mindestens 2 MB umfasst: createParms.AdditionalParms = "reserve_size=2m" Dieser Parameter wird nur verwendet, wenn mit ULConnection.Open eine Verbindung hergestellt wird.
start	Gibt den Speicherort an und startet dann die UltraLite-Engine. Geben Sie den Verbindungsparameter StartLine (START) nur beim Verbinden mit einer Engine an, die aktuell nicht läuft. Der Speicherort ist nur erforderlich, wenn sich die UltraLite-Engine nicht im Systempfad befindet.

Schlüsselwort

Beschreibung

dbn

Kennzeichnet eine geladene Datenbank, mit der eine Verbindung hergestellt werden muss

Wenn eine Datenbank auf einem Server gestartet wird, wird ihr ein Datenbankname zugewiesen, und zwar entweder explizit mit der dbn-Option oder von UltraLite unter Verwendung des Dateinamens, wobei Erweiterung und Pfad weggelassen werden.

Beim Öffnen von Verbindungen sucht UltraLite zunächst nach einer laufenden Datenbank mit einer übereinstimmenden dbn-Option. Wenn keine gefunden wird, startet UltraLite eine neue Datenbank mit dem geeigneten Datenbank-Dateinamenparameter (DatabaseOnDevice oder DatabaseOnDesktop).

Dieser Parameter ist erforderlich, wenn die Anwendung (oder UltraLite-Engine) auf zwei unterschiedliche Datenbanken zugreifen muss, die denselben Basis-Dateinamen haben.

Dieser Parameter wird nur verwendet, wenn mit ULConnection.Open eine Verbindung hergestellt wird.

reserve_size

Reserviert Speicher im Dateisystem für die Speicherung von beständigen UltraLite-Daten.

Mit dem Parameter reserve_size können Sie den für die UltraLite-Datenbank erforderlichen Speicher im Dateisystem vorab zuweisen, ohne Daten einzufügen. Durch das Reservieren von Speicher im Dateisystem können Sie die Performance geringfügig steigern und Fehler aufgrund von zu wenig Speicherplatz verhindern. Standardmäßig wächst die Datei für den beständigen Speicher nur bei Bedarf, wenn die Anwendung die Datenbank aktualisiert.

Beachten Sie, dass reserve_size Speicher im Dateisystem reserviert, wobei auch die Metadaten in der beständigen Speicherdatei einbezogen werden und nicht ausschließlich die unformatierten Daten. Der Metadaten-Overhead und die Datenkomprimierung müssen bei der Ermittlung des erforderlichen Speichers im Dateisystem anhand des Umfangs der Datenbankdaten berücksichtigt werden.

Der Parameter reserve_size reserviert Speicher, indem die Datei für den beständigen Speicher beim Start auf die betreffende Reservierungsgröße gebracht wird, und zwar unabhängig von der zuvor vorhandenen Datei. Die Datei wird niemals gekürzt.

Die folgende Parameterzeichenfolge stellt sicher, dass die Datei für den beständigen Speicher beim Start mindestens 2 MB umfasst: createParms.AdditionalParms = "reserve_size=2m"

Dieser Parameter wird nur verwendet, wenn mit ULConnection.Open eine Verbindung hergestellt wird.

start

Gibt den Speicherort an und startet dann die UltraLite-Engine.

Geben Sie den Verbindungsparameter StartLine (START) nur beim Verbinden mit einer Engine an, die aktuell nicht läuft.

Der Speicherort ist nur erforderlich, wenn sich die UltraLite-Engine nicht im Systempfad befindet.

Weitere Hinweise finden Sie unter UltraLite-Verbindungsparameter.

AdditionalParms-Eigenschaft

Visual Basic-Syntax

C#-Syntax

Ausnahmebedingungen

Bemerkungen

Siehe auch