SqlCeConnection.ChangeDatabase Method

Articolo
01/14/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 _
)

public override void ChangeDatabase (
    string value
)

public:
virtual void ChangeDatabase (
    String^ value
) override

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

Parametri

value
Nome del database.

Valore restituito

True se il database è stato modificato correttamente, in caso contrario, false.

Eccezioni

Tipo di 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 o vuoto né 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.

Esempio

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

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Condividi tramite