SqlCeConnection Class

Artigo
01/14/2011

Representa uma conexão aberta com uma fonte de dados do SQL Server Compact 3.5.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)

Sintaxe

'Declaração
Public NotInheritable Class SqlCeConnection
    Inherits DbConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

public final class SqlCeConnection extends DbConnection

public final class SqlCeConnection extends DbConnection

Comentários

Um objeto SqlCeConnection representa uma conexão exclusiva com uma fonte de dados. Ao criar uma instância da SqlCeConnection, todas as propriedades são definidas com seus valores iniciais. Para obter uma lista desses valores, consulte o construtor da SqlCeConnection.

Se a SqlCeConnection sair do escopo, ela não será fechada. Feche a conexão explicitamente, chamando Close ou Dispose.

O SQL Server Compact 3.5 dá suporte a várias conexões simultâneas, assim como a vários comandos que compartilham a mesma conexão. Isso significa que é possível ter várias instâncias do SqlCeDataReader abertas na mesma conexão. Esse comportamento é diferente do comportamento do System.Data.SqlClient.

Se uma SqlCeException fatal for gerada pelo método que executa um SqlCeCommand, a SqlCeConnection poderá ser fechada. Você pode reabrir a conexão e continuar.

Atualmente, 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 Express, 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)

Hierarquia de herança

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

Exemplo

O exemplo a seguir cria uma SqlCeCommand e uma SqlCeConnection. A SqlCeConnection é aberta e definida como a Connection para o SqlCeCommand. Em seguida, o exemplo chama ExecuteNonQuery e fecha a conexão.

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeConnection Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class

Compartilhar via