SqlCeConnection.ConnectionString-Eigenschaft
Ruft die Zeichenfolge ab, mit der eine Datenbank geöffnet wird, oder legt diese fest.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
Public Overrides Property ConnectionString As String
Get
Set
'Usage
Dim instance As SqlCeConnection
Dim value As String
value = instance.ConnectionString
instance.ConnectionString = value
public override string ConnectionString { get; set; }
public:
virtual property String^ ConnectionString {
String^ get () override;
void set (String^ value) override;
}
abstract ConnectionString : string with get, set
override ConnectionString : string with get, set
override function get ConnectionString () : String
override function set ConnectionString (value : String)
Eigenschaftswert
Typ: System.String
Die Verbindungszeichenfolge des .NET Compact Framework-Datenanbieters für SQL Server Compact, die den Datenquellennamen und andere Parameter enthält, die zum Herstellen der Anfangsverbindung erforderlich sind. Der Standardwert ist eine leere Zeichenfolge.
Implementiert
IDbConnection.ConnectionString
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | Es wurde ein ungültiges Argument für eine Verbindungszeichenfolge bereitgestellt. |
Hinweise
Die ConnectionString-Eigenschaft kann nur festgelegt werden, wenn die Verbindung geschlossen ist. Viele Verbindungszeichenfolgenwerte verfügen über entsprechende schreibgeschützte Eigenschaften. Wenn die Verbindungszeichenfolge festgelegt ist, werden diese Eigenschaften aktualisiert, sofern kein Fehler aufgetreten ist. In diesem Fall wird keine der Eigenschaften aktualisiert. SqlCeConnection-Eigenschaften geben nur die in ConnectionString enthaltenen Einstellungen zurück.
Beim Zurücksetzen von ConnectionString für eine geschlossene Verbindung werden alle Verbindungszeichenfolgenwerte (und die zugeordneten Eigenschaften) einschließlich des Kennworts zurückgesetzt.
In der folgenden Tabelle werden die in SQL Server Compact unterstützten ConnectionString-Eigenschaften aufgeführt.
Eigenschaft |
Beschreibung |
|---|---|
Datenquelle |
Der Dateipfad und Name der SQL Server Compact-Datenbank. Verwenden Sie für die Angabe eines relativen Pfads vom Anwendungsverzeichnis zur Datenbank folgende Ersatzzeichenfolge: Datenquelle = |DataDirectory| (eingeschlossen in senkrechte Striche). Verwenden Sie die SetData()-Methode für das AppDomain-Objekt, um das Datenverzeichnis der Anwendung festzulegen. DataDirectory wird für Geräte nicht unterstützt. Weitere Informationen finden Sie unter Installieren und Bereitstellen auf einem Desktopcomputer (SQL Server Compact). |
Kennwort oder Pwd oder Datenbankkennwort oder ssce:Datenbankkennwort |
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 die Verschlüsselung der Datenbank aktiviert wird. Wenn ein Kennwort angegeben wird, wird automatisch die Verschlüsselung der Datenbank aktiviert. Wenn Sie ein leeres Kennwort angeben, wird die Datenbank nicht verschlüsselt. |
ssce:enlist oder enlist |
Der Standardwert von "enlist" ist "false". Er kann jedoch auf "true" festgelegt werden. Wenn eine Verbindung mit einer SQL Server Compact-Datenbank geöffnet wird, während "enlist" auf "true" festgelegt ist, wird die Verbindung zu einer Transaktion hochgestuft. |
ssce:encryption mode oder encryption mode |
Die Werte für diese Eigenschaft lauten: Modulstandard oder Plattformstandard Der Standardwert ist "Plattformstandard". .gif "Hinweis") Hinweis
Diese Eigenschaft wird nur zum Zeitpunkt der Erstellung einer Datenbank berücksichtigt und beim Herstellen einer Verbindung mit einer vorhandenen Datenbank ignoriert.
|
Verschlüsseln oder Datenbank verschlüsseln oder ssce:Datenbank verschlüsseln |
Ein boolescher Wert, der bestimmt, ob die Datenbank verschlüsselt ist. Muss auf true festgelegt werden, um die Verschlüsselung zu aktivieren, oder auf false, wenn keine Verschlüsselung verwendet wird. Wenn nichts anderes angegeben ist, lautet der Standardwert false. Bei aktivierter Verschlüsselung muss bei der password-Eigenschaft außerdem ein Kennwort angegeben werden. Wenn ein Kennwort angegeben wird, wird die Verschlüsselung aktiviert und zwar unabhängig von der Einstellung dieser Eigenschaft. Hinweis
Diese Eigenschaft wird nur zum Zeitpunkt der Erstellung einer Datenbank berücksichtigt und beim Herstellen einer Verbindung mit einer vorhandenen Datenbank ignoriert. Wenn SSCE:Datenbankkennwort angegeben wird, wird die Datenbank immer verschlüsselt, und zwar unabhängig davon, ob SSCE:Datenbank verschlüsseln angeben wurde.
|
Maximale Puffergröße oder ssce:maximale Puffergröße |
Die maximale Speichergröße in KB, die SQL Server Compact verwenden kann, bevor mit dem Leeren der Änderungen auf den Datenträger begonnen wird. Wenn nichts anderes angegeben ist, lautet der Standardwert 640. |
Maximale Datenbankgröße oder ssce:maximale Datenbankgröße |
Die maximale Größe der Datenbank in MB. Wenn nichts anderes angegeben ist, lautet der Standardwert 128. |
Modus oder Dateimodus oder ssce:Modus |
Der beim Öffnen der Datenbankdatei zu verwendende Modus. Gültige Werte finden Sie in der folgenden Tabelle. Wenn nichts anderes angegeben wird, lautet der Standardwert "Lesen und Schreiben". |
Standardsperrungstimeout oder ssce: Standardsperrungstimeout |
Der Standardzeitwert in Millisekunden, den eine Transaktion auf eine Sperre wartet. Wenn nichts anderes angegeben ist, lautet der Standardwert 2000. |
Standardsperrenausweitung oder ssce:Standardsperrenausweitung |
Die Anzahl von Sperren, die eine Transaktion abruft, bevor mit der Eskalation von Zeile zu Seite oder von Seite zu Tabelle begonnen wird. Wenn nichts anderes angegeben ist, lautet der Standardwert 100. |
Entleerungsintervall oder ssce:Entleerungsintervall |
Angegebene Intervallzeit (in Sekunden), bevor alle durchgeführten Transaktionen auf den Datenträger weggeschrieben werden. Wenn nichts anderes angegeben ist, lautet der Standardwert 10. |
Schwellenwert für die automatische Verkleinerung oder ssce:Schwellenwert für die automatische Verkleinerung |
Der zulässige Prozentsatz an freiem Speicherplatz in der Datenbankdatei, bevor die automatische Verkleinerung ausgeführt wird. Beträgt der Wert 100, wird die automatische Verkleinerung deaktiviert. Wenn nichts anderes angegeben ist, lautet der Standardwert 60. |
Temporärer Pfad oder Verzeichnis für temporäre Dateien oder ssce:Verzeichnis für temporäre Dateien |
Der Speicherort der temporären Datenbank. Wenn nichts anderes angegeben ist, wird die in den Eigenschaften der Datenquelle für temporäres Speichern angegebene Datenbank als Standard verwendet. |
temp file max size |
Die maximale Größe der temporären Datenbankdatei in MB. Wenn nichts anderes angegeben ist, lautet der Standardwert 128. |
persist security info |
Wenn der Wert auf false festgelegt ist (dringend empfohlen) und die Verbindung geöffnet ist oder sich jemals im geöffneten Zustand befunden hat, werden sicherheitsrelevante Informationen, z. B. das Kennwort, nicht als Teil der Verbindung zurückgegeben. Das Zurücksetzen der Verbindungszeichenfolge setzt alle Werte der Verbindungszeichenfolge einschließlich des Kennworts zurück. Der Standardwert ist false. |
Gebietsschemabezeichner oder LCID oder anfängliche LCID |
Die Gebietsschema-ID (LCID), die mit der Datenbank zu verwenden ist. Gültige LCID-Werte werden in der CultureInfo-Klasse aufgelistet. Hinweis
Diese Eigenschaft wird nur zum Zeitpunkt der Erstellung einer Datenbank berücksichtigt und beim Herstellen einer Verbindung mit einer vorhandenen Datenbank ignoriert.
|
Unterscheidung nach Groß-/Kleinschreibung oder CaseSensitive |
Ein boolescher Wert, der bestimmt, ob die Groß-/Kleinschreibung bei der Datenbanksortierung berücksichtigt wird. Muss auf true festgelegt werden, um die Groß-/Kleinschreibung bei der Sortierung zu berücksichtigen, oder auf false, um die Groß-/Kleinschreibung bei der Sortierung nicht zu berücksichtigen. Wenn nichts anderes angegeben ist, lautet der Standardwert false. Wenn Sie eine Verbindung mit einer vorhandenen SQL Server Compact-Datenbank herstellen und die Verbindungszeichenfolge die Eigenschaft "Unterscheidung nach Groß-/Kleinschreibung" enthält, wird diese Einstellung von SQL Server Compact 3.5 SP1 ignoriert. Hinweis
Diese Eigenschaft wird nur zum Zeitpunkt der Erstellung einer Datenbank berücksichtigt und beim Herstellen einer Verbindung mit einer vorhandenen Datenbank ignoriert.
|
Die folgende Tabelle zeigt gültige Werte für die mode-Eigenschaft der Verbindungszeichenfolge.
Wert |
Definition |
|---|---|
Read Write |
Ermöglicht es mehreren Prozessen, die Datenbank zu öffnen und zu ändern. Dies ist die Standardeinstellung, wenn die mode-Eigenschaft nicht angegeben wird. |
Read Only |
Ermöglicht das Öffnen einer schreibgeschützten Kopie der Datenbank. |
Exclusive |
Lässt kein Öffnen oder Ändern der Datenbank durch andere Prozesse zu. |
Shared Read |
Ermöglicht anderen Prozessen das Lesen, jedoch nicht das Ändern der Datenbank, während diese geöffnet ist. |
Eine vorläufige Validierung der Verbindungszeichenfolge wird durchgeführt, wenn die Eigenschaft festgelegt ist. Wenn eine Anwendung die Open-Methode aufruft, wird die Verbindungszeichenfolge vollständig validiert. Wenn die Verbindungszeichenfolge nicht unterstützte oder ungültige Eigenschaften enthält, wird zu diesem Zeitpunkt eine Laufzeitausnahme ausgelöst, z. B. ArgumentException.
Für Verbindungszeichenfolgen gelten die folgenden Regeln:
Alle Leerzeichen werden ignoriert, sofern sie nicht in einem Wert vorkommen oder in Anführungszeichen stehen.
Schlüsselwort-Wert-Paare müssen durch ein Semikolon (;) getrennt werden. 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.
Bei Namen wird die Groß- und Kleinschreibung nicht berücksichtigt.
Wenn ein Eigenschaftenname in einer Verbindungszeichenfolge mehrfach enthalten ist, wird der dem letzten Auftreten zugeordnete Wert verwendet.
Werte können in einfachen oder doppelten Anführungszeichen eingeschlossen sein (z. B. Name='Wert' oder Name="Wert"). Innerhalb einer Verbindungszeichenfolge können entweder einfache oder doppelte Anführungszeichen durch Verwendung des anderen Trennzeichens verwendet werden. In den folgenden Beispielen werden gültige Verwendungen von Anführungszeichen innerhalb einer Verbindungszeichenfolge aufgeführt:
"data source='MyDb.sdf'; mode=Exclusive;" 'data source="MyDb.sdf"; mode=Exclusive;'Die folgenden Beispiele sind jedoch nicht gültig:
"data source="MyDb.sdf"; mode=Exclusive;" 'data source='MyDb.sdf'; mode=Exclusive;'
Beispiele
Im folgenden Beispiel wird eine SqlCeConnection-Klasse erstellt, und einige ihrer Eigenschaften in der Verbindungszeichenfolge werden festgelegt.
Dim conn As New SqlCeConnection()
' Set some connection string properties e.g.:
'
conn.ConnectionString = _
"Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
"Password = '<password>'; File Mode = 'shared read'; " & _
"Max Database Size = 256; Max Buffer Size = 1024"
conn.Open()
' You can change the database while preserving
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")
SqlCeConnection conn = new SqlCeConnection();
// Set some connection string properties e.g.:
//
conn.ConnectionString =
"Persist Security Info = False; Data Source = 'SalesData.sdf';" +
"Password = '<password>'; File Mode = 'shared read'; " +
"Max Database Size = 256; Max Buffer Size = 1024";
conn.Open();
// You can change the database while preserving
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");
Siehe auch
Verweis
System.Data.SqlServerCe-Namespace