ConnectionString-Eigenschaft

Artikel
01/17/2011

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)

Eigenschaftenwert

Typ: System. . :: . .String
Die Verbindungszeichenfolge des .NET Compact Framework-Datenanbieters für SQL Server Compact 3.5, 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 3.5 unterstützten ConnectionString-Eigenschaften aufgeführt.

Eigenschaft	Beschreibung
Datenquelle	Pfad und Name der SQL Server Compact 3.5-Datenbank. Verwenden Sie für die Angabe eines relativen Pfads vom Anwendungsverzeichnis zur Datenbank folgende Ersatzzeichenfolge: Data Source = \|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 3.5-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 oder PPC2003-Kompatibilität. Der Standardwert ist Plattformstandard. 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 3.5 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");