SqlCeEngine Class

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

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

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeEngine
    Implements IDisposable
public sealed class SqlCeEngine : IDisposable
public ref class SqlCeEngine sealed : IDisposable
public final class SqlCeEngine implements IDisposable
public final class SqlCeEngine implements IDisposable

Remarques

SQL Server Compact 3.5 n'est pas optimisé pour servir de base de données aux sites Web. Par défaut, les connexions à partir d'applications ASP.NET sont bloquées dans SQL Server Compact 3.5. SQL Server Compact 3.5 est optimisé pour être utilisé en tant que base de données incorporée dans des applications. L'utilisation de SQL Server Compact 3.5 en tant que base de données pour les sites Web requiert la prise en charge de plusieurs utilisateurs et des modifications simultanées de données. Cela peut entraîner des problèmes de performance. Par conséquent, ces scénarios ne sont pas pris en charge. D'autres éditions de SQL Server, y compris SQL Server 2005 Express Edition et versions suivantes, sont optimisées pour servir de base de données pour les sites Web.

SQL Server Compact 3.5 peut être utilisé avec ASP.NET dans des scénarios d'application dans lesquels ASP.NET est utilisé pour créer des bases de données SQL Server Compact 3.5 pour des scénarios de synchronisation. Utilisez le code suivant pour modifier le comportement par défaut de SQL Server Compact 3.5 afin de travailler avec ASP.NET.

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

Hiérarchie d'héritage

System.Object
  System.Data.SqlServerCe.SqlCeEngine

Exemple

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

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 (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

SqlCeEngine Members
System.Data.SqlServerCe Namespace