Compartilhar via


Classe SqlCeConnection

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

Hierarquia de herança

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

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

Sintaxe

'Declaração
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'Uso
Dim instance As SqlCeConnection
public sealed class SqlCeConnection : DbConnection
public ref class SqlCeConnection sealed : public DbConnection
[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end
public final class SqlCeConnection extends DbConnection

O tipo SqlCeConnection expõe os membros a seguir.

Construtores

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

Início

Propriedades

  Nome Descrição
Propriedade protegida CanRaiseEvents (herança de Component)
Propriedade pública ConnectionString Obtém ou define a cadeia de caracteres usada para abrir um banco de dados. (Substitui DbConnection.ConnectionString.)
Propriedade pública ConnectionTimeout Obtém o tempo de espera ao tentar estabelecer uma conexão, antes de encerrar a tentativa e gerar um erro. (Substitui DbConnection.ConnectionTimeout.)
Propriedade pública Container (herança de Component)
Propriedade pública Database Obtém o nome do banco de dados atual ou do banco de dados a ser usado quando uma conexão está aberta. (Substitui DbConnection.Database.)
Propriedade pública DatabaseIdentifier Obtém o identificador exclusivo do banco de dados atual ao sincronizar.
Propriedade pública DataSource Obtém o nome de arquivo da fonte de dados. (Substitui DbConnection.DataSource.)
Propriedade protegida DbProviderFactory (herança de DbConnection)
Propriedade protegida DesignMode (herança de Component)
Propriedade protegida Events (herança de Component)
Propriedade pública ServerVersion Retorna o número da versão do banco de dados como uma cadeia de caracteres. (Substitui DbConnection.ServerVersion.)
Propriedade pública Site (herança de Component)
Propriedade pública State Obtém o estado atual da conexão. (Substitui DbConnection.State.)

Início

Métodos

  Nome Descrição
Método protegido BeginDbTransaction (herança de DbConnection)
Método público BeginTransaction() Inicia uma transação do banco de dados.
Método público BeginTransaction(IsolationLevel) Inicia uma transação do banco de dados com o valor de IsolationLevel atual.
Método público ChangeDatabase Altera o banco de dados atual para uma SqlCeConnection aberta. (Substitui DbConnection.ChangeDatabase(String).)
Método público Close Fecha a conexão com a fonte de dados. Este é o método preferencial para fechar qualquer conexão aberta. (Substitui DbConnection.Close().)
Método público CreateCommand Cria e retorna um objeto SqlCeCommand associado com a SqlCeConnection.
Método protegido CreateDbCommand (herança de DbConnection)
Método público CreateObjRef (herança de MarshalByRefObject)
Método público Dispose() Libera todos os recursos usados pela instância atual da classe SqlCeConnection.
Método protegido Dispose(Boolean) (herança de Component)
Método público EnlistTransaction(Transaction) (herança de DbConnection)
Método público EnlistTransaction(Transaction) Inscreve-se no Transaction especificado.
Método público Equals (herança de Object)
Método protegido Finalize (herança de Component)
Método público GetDatabaseInfo Retorna um conjunto de pares de Valor de Chave com informações sobre a localidade, o modo de criptografia e a configuração de distinção entre maiúsculas e minúsculas do banco de dados conectado.
Método público GetHashCode (herança de Object)
Método público GetLifetimeService (herança de MarshalByRefObject)
Método público GetSchema() Retorna as informações de esquema para a fonte de dados desta SqlCeConnection. (Substitui DbConnection.GetSchema().)
Método público GetSchema(String) Retorna informações de esquema para a fonte de dados desta SqlCeConnection usando a cadeia de caracteres especificada para o nome do esquema. (Substitui DbConnection.GetSchema(String).)
Método público GetSchema(String, array<String[]) Retorna informações de esquema para a fonte de dados desta SqlCeConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeias de caracteres especificada para os valores de restrição. (Substitui DbConnection.GetSchema(String, array<String[]).)
Método protegido GetService (herança de Component)
Método público GetType (herança de Object)
Método público InitializeLifetimeService (herança de MarshalByRefObject)
Método protegido MemberwiseClone() (herança de Object)
Método protegido MemberwiseClone(Boolean) (herança de MarshalByRefObject)
Método protegido OnStateChange (herança de DbConnection)
Método público Open Abre uma conexão de banco de dados com as configurações da propriedade especificadas pela ConnectionString. (Substitui DbConnection.Open().)
Método público ToString (herança de Component)

Início

Eventos

  Nome Descrição
Evento público Disposed (herança de Component)
Evento público FlushFailure Ocorre quando a liberação em segundo plano falha.
Evento público InfoMessage Ocorre quando o Provedor de Dados do .NET Compact Framework para SQL Server envia um aviso ou uma mensagem informativa.
Evento público StateChange Ocorre quando o estado atual da conexão é alterado. (Substitui DbConnection.StateChange.)

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasMétodo privado IDbConnection.BeginTransaction() (herança de DbConnection)
Implementações de interfaces explícitasMétodo privado IDbConnection.BeginTransaction(IsolationLevel) (herança de DbConnection)
Implementações de interfaces explícitasMétodo privado IDbConnection.CreateCommand (herança de DbConnection)

Início

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 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.

Exemplos

O exemplo a seguir cria um 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

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

SqlCeDataAdapter

SqlCeCommand