Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.
Ruft die Zeichenfolge ab, mit der eine Datenbank geöffnet wird, oder legt diese fest.
Public Overridable Property ConnectionString As String Implements _ IDbConnection.ConnectionString
[C#]
public virtual string ConnectionString {get; set;}
[C++]
public: __property virtual String* get_ConnectionString();public: __property virtual void set_ConnectionString(String*);
[JScript]
public function get ConnectionString() : String;public function set ConnectionString(String);
Eigenschaftenwert
Die Verbindungszeichenfolge des .NET Compact Framework-Datenproviders für SQL Server CE, 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
| Ausnahmetyp | 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 im 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. Wenn Sie z. B. eine Verbindungszeichenfolge festlegen, die "Data Source =\my app\Northwind.sdf" enthält, und die Verbindungszeichenfolge auf "Data Source =\my app\Master.sdf; Password=<Kennwort>" zurücksetzen, ist die DataSource-Eigenschaft nicht mehr auf Northwind.sdf festgelegt.
In der folgenden Tabelle werden die in SQL Server CE unterstützten ConnectionString-Eigenschaften aufgeführt. Weitere Informationen finden Sie in der SQL Server CE-Onlinedokumentation.
| Name | Beschreibung |
|---|---|
| data source | Name der SQL Server CE-Datenbank, die mit "\my app\myDB.sdf" verbunden wird. |
| password | Datenbankkennwort, das bis zu 40 Zeichen lang sein kann. |
| 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. |
| encrypt database | Boolescher Wert, der bestimmt, ob die Datenbank verschlüsselt wird, wenn die Plattform die Verschlüsselung unterstützt. |
| max buffer size | Die maximale Speichergröße in KB, die SQL Server CE verwenden kann, bevor mit dem Wegschreiben der Änderungen auf den Datenträger begonnen wird. |
| locale identifier | Lokale ID (LCID) der Einstellung. |
| temp file directory | Speicherort der temporären Datenbank. |
Eine vorläufige Gültigkeitsprüfung der Verbindungszeichenfolge wird durchgeführt, wenn die Eigenschaft festgelegt ist. Wenn eine Anwendung die Open-Methode aufruft, wird die Verbindungszeichenfolge vollständig überprüft. Wenn die Verbindungszeichenfolge nicht unterstützte oder ungültige Eigenschaften enthält, wird zu diesem Zeitpunkt eine Laufzeitausnahme ausgelöst, z. B. ArgumentException.
Werte können in einfachen oder doppelten Anführungszeichen eingeschlossen sein (z. B. name='Wert' oder name="Wert"). In einer Verbindungszeichenfolge können einfache oder doppelte Anführungszeichen verwendet werden, wenn das jeweils andere als Trennzeichen verwendet wird, z. B. name="Einstein'sche Formel" oder name= 'Einstein"sche Formel', aber nicht name= 'Einstein'sche Formel'' oder name= ""Einstein"". 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 Wertes 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.
Beispiel
[Visual Basic, C#] Im folgenden Beispiel wird eine SqlCeConnection erstellt, und einige ihrer Eigenschaften in der Verbindungszeichenfolge werden festgelegt.
Dim conn As New SqlCeConnection()
conn.ConnectionString = "Persist Security Info=False; Data Source = Northwind.sdf;" + _
"Password = <password>; server=mySQLServer;Connect Timeout=30"
conn.Open()
[C#]
SqlCeConnection conn = new SqlCeConnection();
conn.ConnectionString = "Persist Security Info=False; Data Source = Northwind.sdf;" +
"Password = <password>; server=mySQLServer;Connect Timeout=30";
conn.Open();
[C++, JScript] Für C++ oder JScript ist kein Beispiel verfügbar. Klicken Sie zum Anzeigen eines Beispiels für Visual Basic oder C# in der linken oberen Ecke der Seite auf die Schaltfläche "Sprachfilter" .gif)
.
Anforderungen
Plattformen: .NET Compact Framework - Windows CE .NET
.NET Framework-Sicherheit:
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
SqlCeConnection-Klasse | SqlCeConnection-Member | System.Data.SqlServerCe-Namespace