SqlCeEngine Class

Representa las propiedades, métodos y otros objetos del objeto del motor de SQL Server Compact 3.5. No se puede heredar esta clase.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
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

Notas

SQL Server Compact 3.5 no está optimizado para funcionar como base de datos para sitios web. De forma predeterminada, las conexiones de aplicaciones conectadas con ASP.NET se encuentran bloqueadas en SQL Server Compact 3.5. SQL Server Compact 3.5 está optimizado para su uso como base de datos incrustada en aplicaciones. El uso de SQL Server Compact 3.5 como base de datos de sitios web requiere compatibilidad con varios usuarios y cambios de datos simultáneos. De esta forma, se pueden producir problemas de rendimiento. Por lo tanto, no se admiten estos escenarios. Otras ediciones de SQL Server, incluido SQL Server 2005 Express Edition y versiones posteriores se han optimizado para servir de base de datos de sitios web.

SQL Server Compact 3.5 se puede utilizar con ASP.NET en escenarios de aplicación donde ASP.NET se utiliza con el fin de crear bases de datos de SQL Server Compact 3.5 para escenarios de sincronización. Utilice el código siguiente para cambiar el comportamiento predeterminado de SQL Server Compact 3.5 para trabajar en ASP.NET.

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

Jerarquía de herencia

System.Object
  System.Data.SqlServerCe.SqlCeEngine

Ejemplo

En el siguiente ejemplo se muestra cómo crear una base de datos SQL Server Compact 3.5 nueva.

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();
}

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeEngine Members
System.Data.SqlServerCe Namespace