LocalConnectionString-Eigenschaft (RDA)
Mit der LocalConnectionString -Eigenschaft wird die OLE DB-Verbindungszeichenfolge für die Datenbank von SQL Server Compact 3.5 (SQL Server Compact 3.5 ) auf dem Microsoft Windows CE-basierten Gerät angegeben.
Syntax
object.LocalConnectionString(value)
Betrifft
RDA-Objekt von SQL Server Compact 3.5
Datentyp
String
Änderbar
Lesen/Schreiben
Prototyp
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Generische Parameter
Parameter | Beschreibung |
---|---|
value |
Die OLE DB-Verbindungszeichenfolge für die SQL Server Compact 3.5 -Datenbank. |
Hinweise
In der folgenden Tabelle sind die verfügbaren Eigenschaftennamen für die OLE DB-Verbindungszeichenfolge aufgelistet.
Eigenschaft | Beschreibung |
---|---|
data source |
Dateipfad und Name der SQL Server Compact 3.5-Datenbank. Geben Sie den absoluten Pfad der Datenbankdatei anstelle eines relativen Pfades an.
Hinweis:
Eine Anwendung, die auf einem Desktopcomputer ausgeführt wird, kann keine Datenbankverbindung mit einer SDF-Datei auf einem Gerät herstellen. Ebenso kann eine Anwendung, die auf einem Gerät ausgeführt wird, keine Datenbankverbindung mit einer SDF-Datei auf einem Desktopcomputer herstellen.
|
ssce: database password |
Das Datenbankkennwort, das bis zu 40 Zeichen lang sein kann. Wenn nichts anderes angegeben ist, wird in der Standardeinstellung kein Kennwort verwendet. Diese Eigenschaft ist erforderlich, wenn Sie Verschlüsselung für die Datenbank aktivieren möchten. Wenn Sie ein Kennwort angegeben haben, wird die Verschlüsselung für die Datenbank aktiviert. Wenn Sie ein leeres Kennwort angeben, wird die Datenbank nicht verschlüsselt. |
ssce: encrypt database |
Ein Boolean-Wert, der festlegt, ob die Datenbank verschlüsselt wird. Dieser Wert muss auf true festgelegt werden, um die Verschlüsselung zu aktivieren, oder auf false, wenn keine Verschlüsselung verwendet werden soll. Der Standardwert ist false. Wenn Sie die Verschlüsselung aktivieren, müssen Sie mit der Eigenschaft für Kennwörter ein Kennwort angeben. Wenn Sie ein Kennwort angegeben haben, wird die Verschlüsselung automatisch aktiviert. Es spielt dann keine Rolle, auf welchen Wert diese Eigenschaft festgelegt ist. Wenn ein Kennwort angegeben wird, wird die Datenbank immer verschlüsselt, und zwar unabhängig davon, ob "SSCE:Datenbank verschlüsseln" angeben wurde.
Hinweis:
Die encrypt-Eigenschaft wird in einer späteren Version veraltet sein. Die Eigenschaft wurde in SQL Server Compact 3.5 zum Zweck der Abwärtskompatibilität beibehalten.
|
ssce:encryption mode oder encryption mode |
Die Werte für diese Eigenschaft lauten engine default, platform default oder ppc2003 compatibility. Der Standardwert lautet platform default. |
ssce: max buffer size |
Der größtmögliche Arbeitsspeicher (in KB), den SQL Server Compact 3.5 verwenden kann, bevor Änderungen auf den Datenträger ausgegeben und dann aus dem Speicher gelöscht werden. Ist kein Wert angegeben, ist der Standardwert 640. |
ssce: max database size |
Die maximale Größe der Datenbank in MB. Ist kein Wert angegeben, ist der Standardwert 128. |
ssce:mode |
Der Modus, der verwendet werden soll, wenn Sie die Datenbankdatei öffnen. Die gültigen Werte finden Sie in der nächsten Tabelle. Ist kein Wert angegeben, ist der Standardwert Read/Write. |
ssce: default lock timeout |
Die Standardanzahl von Millisekunden, die eine Transaktion auf eine Sperre wartet. Ist kein Wert angegeben, ist der Standardwert 2000. |
ssce: default lock escalation |
Die Anzahl von Sperren, die eine Transaktion abruft, bevor Sie die Ausweitung von einer Zeile zur Seite oder von einer Seite zur Tabelle versuchen. Ist kein Wert angegeben, ist der Standardwert 100. |
ssce: flush interval |
Gibt die Zeitspanne in Sekunden an, ab der alle Transaktionen, für die ein Commit ausgeführt wurde, auf den Datenträger geleert werden. Ist kein Wert angegeben, ist der Standardwert 10. |
ssce: autoshrink threshold |
Der Prozentsatz an freiem Speicherplatz in der Datenbankdatei, der zulässig ist, bevor eine automatische Verkleinerung gestartet wird. Der Wert 100 deaktiviert die automatische Verkleinerung. Ist kein Wert angegeben, ist der Standardwert 60. |
ssce: temp file directory |
Der Speicherort der temporären Datenbank. Ist kein Wert angegeben, wird als Standard die Datenbank verwendet, die in der Datenquelleneigenschaft für temporäre Speicherung angegeben ist. |
ssce: temp file max size |
Die maximale Größe der temporären Datenbankdatei in MB. Ist kein Wert angegeben, ist der Standardwert 128. |
locale identifier |
Die Gebietsschema-ID (Locale ID, LCID), die mit der Datenbank verwendet werden soll. |
ssce:case sensitive |
Ein boolescher Wert, der festlegt, ob in der Datenbank die Groß-/Kleinschreibung berücksichtigt wird. Diese Eigenschaft muss auf true festgelegt werden, wenn die Groß-/Kleinschreibung berücksichtigt werden soll, oder auf false, wenn die Groß-/Kleinschreibung nicht berücksichtigt werden soll. Der Standardwert ist false.
Hinweis:
Diese Verbindungseigenschaft wurde in SQL Server Compact 3.5 SP1 eingeführt.
|
In der folgenden Tabelle werden gültige Werte für die mode-Eigenschaft der Verbindungszeichenfolge aufgelistet.
Wert | Definition |
---|---|
Read Write |
Ermöglicht, dass mehrere Prozesse die Datenbank öffnen und ändern können. Dies ist die Standardeinstellung, wenn die mode-Eigenschaft nicht angegeben ist. |
Read Only |
Öffnet eine schreibgeschützte Kopie der Datenbank. |
Exclusive |
Verhindert, dass andere Prozesse die Datenbank öffnen oder ändern können. |
Shared Read |
Ermöglicht, dass andere Prozesse die Datenbank, solange Sie diese geöffnet haben, zwar lesen, aber nicht ändern können. |
Die folgenden Regeln gelten für Verbindungszeichenfolgen:
Leerzeichen, die nicht zu einem Wert gehören oder in Anführungszeichen stehen, werden ignoriert.
Paare aus Schlüsselwort und Wert müssen durch ein Semikolon (;) voneinander getrennt sein. Wenn ein Semikolon Teil eines Werts ist, muss es ebenfalls in Anführungszeichen eingeschlossen werden.
Es werden keine Escapesequenzen unterstützt.
Der Werttyp ist nicht relevant.
Für Namen wird die Groß-/Kleinschreibung nicht beachtet.
Gibt es den Namen einer Eigenschaft mehrmals in der Verbindungszeichenfolge, wird der Wert verwendet, der der Eigenschaft bei deren letztem Vorkommen zugewiesen wurde.
Ein Wert kann in einfache oder doppelte Anführungszeichen gesetzt werden; Beispiel: name='Wert' oder name="Wert". In einer Verbindungszeichenfolge können entweder einfache oder doppelte Anführungszeichen verwendet werden, indem das jeweils andere Begrenzungszeichen verwendet wird. In den folgenden Beispielen sind die Anführungszeichen in der jeweiligen Verbindungszeichenfolge in zulässiger Weise verwendet.
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'
- Die folgenden Beispiele sind jedoch nicht gültig:
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'