SqlCeCommand.Connection Property

Obtém ou define a SqlCeConnection usada por esta instância do SqlCeCommand.

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

Sintaxe

'Declaração
Public Property Connection As SqlCeConnection

public SqlCeConnection Connection { get; set; }

public:
property SqlCeConnection^ Connection {
    SqlCeConnection^ get ();
    void set (SqlCeConnection^ value);
}

/** @property */
public SqlCeConnection get_Connection ()

/** @property */
public void set_Connection (SqlCeConnection value)

public function get Connection () : SqlCeConnection

public function set Connection (value : SqlCeConnection)

Valor da propriedade

A conexão com uma fonte de dados. O valor padrão é null.

Exceções

Tipo de exceção	Condição
InvalidOperationException	A propriedade Connection foi alterada enquanto havia uma transação em andamento.

Comentários

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. Assim, é possível ter várias instâncias do SqlCeDataReader abertas na mesma conexão. Esse comportamento é diferente do comportamento do System.Data.SqlClient.

Não será possível definir as propriedades Connection, CommandType e CommandText se a conexão atual estiver executando uma operação Execute ou Fetch.

Se você definir a Connection enquanto uma transação está em andamento e a propriedade Transaction não é igual a null, uma InvalidOperationException será gerada. Se a propriedade Transaction for diferente de null e a transação já tiver sido confirmada ou revertida, Transaction será definida como null.

Exemplo

O exemplo a seguir cria um SqlCeCommand e define a propriedade Connection para um objeto SqlCeConnection.

Dim queryText As String = "SELECT * FROM Categories ORDER BY [Category ID]"
Dim cmd As New SqlCeCommand(queryText)

cmd.Connection = conn
cmd.CommandType = CommandType.Text

string queryText = "SELECT * FROM Categories ORDER BY [Category ID]";
SqlCeCommand cmd = new SqlCeCommand(queryText);

cmd.Connection = conn;
cmd.CommandType = CommandType.Text;

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

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeCommand.CommandText Property
SqlCeCommand.CommandTimeout Property
CommandType