SqlCeConnection.ChangeDatabase Method

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

Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
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
)

Paramètres

• value

Valeur de retour

True si la base de données a été correctement modifiée ; sinon, false.

Exceptions

Remarques

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 null, ê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.

Exemple

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

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

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
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace