SqlCeConnection.ChangeDatabase-Methode

Wechselt die aktuelle Datenbank einer offenen SqlCeConnection-Klasse.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Overrides Sub ChangeDatabase ( _
    value As String _
)
'Usage
Dim instance As SqlCeConnection
Dim value As String

instance.ChangeDatabase(value)

public override void ChangeDatabase (
    string value
)

public:
virtual void ChangeDatabase (
    String^ value
) override

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

Parameter

• value
  Der Datenbankname.

Rückgabewert

True, wenn die Datenbank erfolgreich gewechselt wurde, andernfalls False.

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 (Nothing in Visual Basic)-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.

Beispiel

Das folgende Beispiel veranschaulicht, wie Datenbanken gewechselt werden und dabei die ursprünglichen Verbindungsoptionen erhalten bleiben.

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");

.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 .

Plattformen

Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

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