Clase SqlCeEngine

  • Artículo

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

Jerarquía de herencia

System.Object
  System.Data.SqlServerCe.SqlCeEngine

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

Sintaxis

'Declaración
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'Uso
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

El tipo SqlCeEngine expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público SqlCeEngine() Inicializa una nueva instancia de la clase SqlCeEngine.
Método público SqlCeEngine(String) Inicializa una nueva instancia de la clase SqlCeEngine con la cadena de conexión local especificada.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública LocalConnectionString Obtiene o establece la cadena de conexión con la base de datos SQL Server Compact.

Arriba

Métodos

  Nombre Descripción
Método público Compact Recupera el espacio desaprovechado de la base de datos de SQL Server Compact mediante la creación de un nuevo archivo de base de datos a partir del archivo existente. Este método también se utiliza para cambiar las opciones de orden de intercalación, cifrado o contraseña de la base de datos.
Método público CreateDatabase Crea una nueva base de datos.
Método público Dispose Libera todos los recursos SqlCeEngine de SQL Server Compact.
Método público Equals (se hereda de Object)
Método protegido Finalize (se hereda de Object)
Método público GetHashCode (se hereda de Object)
Método público GetType (se hereda de Object)
Método protegido MemberwiseClone (se hereda de Object)
Método público Repair Repara una base de datos dañada.
Método público Shrink Recupera el espacio desaprovechado de la base de datos de SQL Server Compact moviendo las páginas vacías al final del archivo y, a continuación, truncando el archivo.
Método público ToString (se hereda de Object)
Método público Upgrade() Actualiza una base de datos de SQL Server Compact de la versión 3.5 a la 4.0. Después de la actualización, la base de datos estará cifrada si la base de datos original también lo estaba. En caso contrario, la base de datos actualizada permanecerá sin cifrar.
Método público Upgrade(String) Actualiza una base de datos de SQL Server Compact de la versión 3.5 a la 4.0. La base de datos de destino estará cifrada si el modo de cifrado se especificó en la cadena de conexión de destino. La intercalación de la base de datos distinguirá mayúsculas de minúsculas si la propiedad de distinción entre mayúsculas y minúsculas se establece en true en la cadena de conexión.
Método público Verify() Actualiza las sumas de comprobación para cada página de la base de datos y compara las nuevas sumas de comprobación con los valores esperados.
Método público Verify(VerifyOption) Comprueba la integridad de la base de datos basándose en VerifyOption.

Arriba

Comentarios

SQL Server Compact se ha optimizado para actuar como base de datos para los sitios web y las aplicaciones web. SQL Server Compact se ha optimizado para usarse como base de datos insertada en aplicaciones web. SQL Server Compact se puede usar como una base de datos para sitios web para varios usuarios y cambios de datos simultáneos.

SQL Server Compact se puede usar para desarrollar aplicaciones web ASP.NET. En las versiones anteriores de SQL Server Compact, había que establecer la marca SQLServerCompactEditionUnderWebHosting para usar SQL Server Compact en las aplicaciones web ASP.NET. La marca se quita en SQL Server Compact 4.0.

Ejemplos

En el siguiente ejemplo se muestra cómo crear una base de datos SQL Server Compact 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 estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe