Classe SqlCeEngine

Artigo
01/17/2011

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

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

Comentários

O SQL Server Compact 3.5 não está otimizado para servir como um banco de dados de sites. Por padrão, as conexões de aplicativos conectados ao ASP.NET são bloqueadas no SQL Server Compact 3.5. O SQL Server Compact 3.5 é otimizado para uso como um banco de dados incorporado em aplicativos. A utilização do SQL Server Compact 3.5 como banco de dados de sites exige o suporte para vários usuários e alterações de dados simultâneas. Isso pode causar problemas de desempenho. Portanto, não há suporte para esses cenários. Outras versões do SQL Server, incluindo o SQL Server 2005 Express Edition e versões posteriores, são otimizadas para servir como um banco de dados de sites.

O SQL Server Compact 3.5 pode ser usado com o ASP.NET em cenários de aplicativos nos quais o ASP.NET é usado para criar bancos de dados do SQL Server Compact 3.5 para cenários de sincronização. Use o código a seguir de forma a alterar o comportamento padrão do SQL Server Compact 3.5 para trabalhar no ASP.NET.

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

Exemplos

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

Hierarquia de herança

System. . :: . .Object
System.Data.SqlServerCe..::..SqlCeEngine

Segurança de thread

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Consulte também

Referência

Membros SqlCeEngine

Namespace System.Data.SqlServerCe

Compartilhar via