Compartilhar via

Classe SqlCeEngine

  • Artigo

Representa as propriedades, métodos e outros objetos do objeto Engine do SQL Server Compact. Esta classe não pode ser herdada.

Hierarquia de herança

System.Object
  System.Data.SqlServerCe.SqlCeEngine

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
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

O tipo SqlCeEngine expõe os membros a seguir.

Construtores

  Nome Descrição
Método público SqlCeEngine() Inicializa uma nova instância da classe SqlCeEngine.
Método público SqlCeEngine(String) Inicializa uma nova instância da classe SqlCeEngine com a cadeia de caracteres de conexão local especificada.

Início

Propriedades

  Nome Descrição
Propriedade pública LocalConnectionString Obtém ou define a cadeia de conexão com o banco de dados do SQL Server Compact.

Início

Métodos

  Nome Descrição
Método público Compact Recupera o espaço desperdiçado no banco de dados do SQL Server Compact por meio da criação de um novo arquivo de banco de dados a partir do arquivo existente. Esse método também é usado para alterar as configurações de ordem de agrupamento, criptografia ou senha do banco de dados.
Método público CreateDatabase Cria um novo banco de dados.
Método público Dispose Libera todos os recursos de SQL Server CompactSqlCeEngine.
Método público Equals (herança de Object)
Método protegido Finalize (herança de Object)
Método público GetHashCode (herança de Object)
Método público GetType (herança de Object)
Método protegido MemberwiseClone (herança de Object)
Método público Repair Repara um banco de dados corrompido.
Método público Shrink Recupera o espaço desperdiçado no banco de dados do SQL Server Compact movendo as páginas vazias para o final do arquivo e truncando o arquivo.
Método público ToString (herança de Object)
Método público Upgrade() Atualiza um banco de dados do SQL Server Compact da versão 3.5 para a versão 4.0. Após a atualização, se o banco de dados de origem estiver criptografado, o banco de dados será criptografado. Caso contrário, o banco de dados atualizado não será criptografado.
Método público Upgrade(String) Atualiza um banco de dados do SQL Server Compact da versão 3.5 para a versão 4.0. O banco de dados de destino será criptografado se o modo de criptografia tiver sido especificado na cadeia de caracteres de Conexão de Destino. O agrupamento do banco de dados diferenciará maiúsculas de minúsculas se a propriedade case-sensitive estiver definida como true na cadeia de conexão.
Método público Verify() Recalcula as somas de verificação de cada página do banco de dados e compara as novas somas de verificação com os valores esperados.
Método público Verify(VerifyOption) Verifica a integridade do banco de dados na VerifyOption.

Início

Comentários

O SQL Server Compact é otimizado para funcionar como um banco de dados para sites e aplicativos Web. O SQL Server Compact é otimizado para ser usado como um banco de dados inserido dentro de aplicativos Web. O SQL Server Compact pode ser usado como um banco de dados de sites para vários usuários e alterações de dados simultâneas.

O SQL Server Compact pode ser usado para desenvolver aplicativos Web ASP.NET. Nas versões anteriores do SQL Server Compact, era necessário definir que um sinalizador, SQLServerCompactEditionUnderWebHosting, usasse o SQL Server Compact em aplicativos Web ASP.NET. O sinalizador foi removido no SQL Server Compact 4.0.

Exemplos

O exemplo a seguir demonstra como criar um novo banco de dados do 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();
}

Segurança de thread

Qualquer membro estático público (Shared no Microsoft Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.

Consulte também

Referência

Namespace System.Data.SqlServerCe