Freigeben über

SqlCeConnection.ChangeDatabase-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

Wechselt die aktuelle Datenbank für eine geöffnete SqlCeConnection.

Public Overridable Sub ChangeDatabase( _
   ByVal value As String _) Implements IDbConnection.ChangeDatabase
[C#]
public virtual void ChangeDatabase(stringvalue);
[C++]
public: virtual void ChangeDatabase(String* value);
[JScript]
public function ChangeDatabase(
   value : String);

Parameter

  • value
    Der Datenbankname.

Rückgabewert

true, wenn die Datenbank erfolgreich gewechselt wurde, andernfalls false.

Implementiert

IDbConnection.ChangeDatabase

Ausnahmen

Ausnahmetyp Bedingung
ArgumentException Der Datenbankname ist ungültig.
InvalidOperationException Die Verbindung ist nicht offen.
SqlCeException Die Datenbanken können nicht gewechselt werden.

Hinweise

Der im value-Parameter angegebene Name muss ein gültiger Datenbankname sein. Der Name muss den vollständigen Pfad zur Datenbank darstellen, z. B. "\my app\myDB.sdf". Der value-Parameter darf keinen NULL-Wert enthalten, nicht leer sein und keine Zeichenfolge enthalten, die nur aus Leerzeichen besteht.

ChangeDatabase wendet dieselben Eigenschaften, die zum Öffnen der aktuellen Datenbank verwendet wurden, auf die neue Datenbank an, mit Ausnahme des Kennworts, das auf eine leere Zeichenfolge festgelegt wird.

Wenn für die neue Datenbank ein Kennwort erforderlich ist, schlägt der Aufruf fehl. In diesem Fall müssen Sie zum Wechseln der Datenbank die ursprüngliche Verbindung schließen, eine neue Verbindungszeichenfolge angeben und dann die Verbindung erneut öffnen.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

Siehe auch

SqlCeConnection-Klasse | SqlCeConnection-Member | System.Data.SqlServerCe-Namespace

  • Last updated on