Classe SqlCeEngine

  • Article

Représente les propriétés, méthodes et autres objets de l'objet Engine SQL Server Compact. Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

System.Object
  System.Data.SqlServerCe.SqlCeEngine

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

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'Utilisation
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

Le type SqlCeEngine expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique SqlCeEngine() Initialise une nouvelle instance de la classe SqlCeEngine.
Méthode publique SqlCeEngine(String) Initialise une nouvelle instance de la classe SqlCeEngine avec la chaîne de connexion locale spécifiée.

Haut de la page

Propriétés

  Nom Description
Propriété publique LocalConnectionString Obtient ou définit la chaîne de connexion de la base de données SQL Server Compact.

Haut de la page

Méthodes

  Nom Description
Méthode publique Compact Récupère l'espace perdu dans la base de données SQL Server Compact en créant un fichier de base de données à partir du fichier existant. Cette méthode est également utilisée pour modifier les paramètres d'ordre d'assemblage, de chiffrement ou de mot de passe de la base de données.
Méthode publique CreateDatabase Crée une base de données.
Méthode publique Dispose Libère toutes les ressources SQL Server Compact SqlCeEngine.
Méthode publique Equals (hérité de Object)
Méthode protégée Finalize (hérité de Object)
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetType (hérité de Object)
Méthode protégée MemberwiseClone (hérité de Object)
Méthode publique Repair Répare une base de données endommagée.
Méthode publique Shrink Récupère l'espace perdu dans la base de données SQL Server Compact en déplaçant les pages vides à la fin du fichier, puis en tronquant le fichier.
Méthode publique ToString (hérité de Object)
Méthode publique Upgrade() Met à niveau une base de données SQL Server Compact de la version 3.5 à la version 4.0. Après la mise à niveau, la base de données sera chiffrée si la base de données source était chiffrée. Dans le cas contraire, la base de données mise à niveau ne sera pas chiffrée.
Méthode publique Upgrade(String) Met à niveau une base de données SQL Server Compact de la version 3.5 à la version 4.0. La base de données de destination sera chiffrée si le mode de chiffrement était spécifié dans la chaîne de connexion de destination. Le classement de la base de données respecte la casse si la valeur true est affectée à la propriété de respect de la casse dans la chaîne de connexion.
Méthode publique Verify() Recalcule les sommes de contrôle de chaque page de la base de données et compare les nouvelles sommes de contrôle aux valeurs attendues.
Méthode publique Verify(VerifyOption) Vérifie l'intégrité de la base de données conformément à VerifyOption.

Haut de la page

Notes

SQL Server Compact est optimisé pour servir de base de données aux sites Web et aux applications Web. SQL Server Compact est optimisé pour être utilisé comme base de données incorporée dans les applications Web. SQL Server Compact peut être utilisé comme base de données pour les sites Web pour plusieurs utilisateurs et pour des modifications de données simultanées.

SQL Server Compact peut être utilisé pour développer des applications Web ASP.NET. Dans les versions précédentes de SQL Server Compact, un indicateur, SQLServerCompactEditionUnderWebHosting devait être défini pour utiliser SQL Server Compact dans les applications Web ASP.NET. L'indicateur est supprimé dans SQL Server Compact 4.0.

Exemples

L'exemple suivant illustre la création d'une base de données SQL Server Compact.

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
finally {
    conn.Close();
}

Sécurité des threads

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

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe