Méthode SqlCeConnection.ChangeDatabase

Article
05/27/2011

Modifie la base de données active d'un SqlCeConnection ouvert.

Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Overrides Sub ChangeDatabase ( _
    value As String _
)
'Utilisation
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
)

Paramètres

value
Type : System.String
Nom de la base de données.

Implémente

IDbConnection.ChangeDatabase(String)

Exceptions

Exception	Condition
ArgumentException	Le nom de la base de données n'est pas valide.
InvalidOperationException	La connexion n'est pas ouverte.
SqlCeException	Les bases de données ne peuvent pas être modifiées.

Notes

Le nom fourni dans le paramètre value doit être un nom de base de données valide. Le nom doit correspondre au chemin d'accès complet de la base de données ; par exemple, "\my app\myDB.sdf". Le paramètre value ne peut pas être nullune référence Null (Nothing dans Visual Basic), être vide ou contenir une chaîne ne comportant que des caractères vierges.

ChangeDatabase applique à la nouvelle base de données les propriétés utilisées pour ouvrir la base de données en cours, sauf le mot de passe, qui reçoit une valeur correspondant à une chaîne vide.

Si la nouvelle base de données requiert un mot de passe, cet appel échoue. Dans ce cas, pour changer de base de données, vous devez fermer la connexion initiale, spécifier une nouvelle chaîne de connexion, puis rouvrir la connexion.

Exemples

L'exemple suivant montre comment basculer entre des bases de données tout en conservant les options de connexion d'origine.

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

Voir aussi

Référence

SqlCeConnection Classe

Espace de noms System.Data.SqlServerCe

Partager via