Metodo SqlCeConnection.ChangeDatabase

Articolo
05/27/2011

Modifica il database corrente per un oggetto SqlCeConnection aperto.

Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public Overrides Sub ChangeDatabase ( _
    value As String _
)
'Utilizzo
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
)

Parametri

value
Tipo: System.String
Nome del database.

Implementa

IDbConnection.ChangeDatabase(String)

Eccezioni

Eccezione	Condizione
ArgumentException	Il nome del database non è valido.
InvalidOperationException	La connessione non è aperta.
SqlCeException	Non è possibile modificare i database.

Osservazioni

Il nome fornito nel parametro value deve essere un nome di database valido. Deve essere il percorso completo al database, ad esempio "\my app\myDB.sdf". Il parametro value non può essere Null, vuoto o contenere una stringa in cui non è presente alcun carattere.

Il metodo ChangeDatabase applica al nuovo database le stesse proprietà utilizzate per aprire il database corrente, tranne la password che verrà impostata su una stringa vuota.

Se il nuovo database richiede una password, la chiamata avrà esisto negativo. In questo caso, per modificare i database è necessario chiudere la connessione originale, specificare una nuova stringa di connessione, quindi riaprire la connessione.

Esempi

Nell'esempio che segue viene illustrato come passare da un database all'altro conservando le opzioni di connessione originali.

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

Vedere anche

Riferimento

SqlCeConnection Classe

Spazio dei nomi System.Data.SqlServerCe

Condividi tramite