SqlCeConnection.ChangeDatabase-Methode

Artikel
05/27/2011

Wechselt die aktuelle Datenbank für ein geöffnetes SqlCeConnection-Element.

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

abstract ChangeDatabase : 
        value:string -> unit 
override ChangeDatabase : 
        value:string -> unit

public override function ChangeDatabase(
    value : String
)

Parameter

value
Typ: System.String
Der Datenbankname.

Implementiert

IDbConnection.ChangeDatabase(String)

Ausnahmen

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

Hinweise

Im value-Parameter muss ein gültiger Datenbankname angegeben werden. Der Name muss den vollständigen Pfad zur Datenbank darstellen, z. B. "\my app\myDB.sdf". Der value-Parameter darf nicht NULL oder leer sein. Außerdem darf er 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.

Beispiele

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

Siehe auch

Verweis

SqlCeConnection Klasse

System.Data.SqlServerCe-Namespace

Freigeben über