Propriedade do RDL SqlCeCommand.Connection
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
Get
Set
'Uso
Dim instance As SqlCeCommand
Dim value As SqlCeConnection
value = instance.Connection
instance.Connection = value
public SqlCeConnection Connection { get; set; }
public:
property SqlCeConnection^ Connection {
SqlCeConnection^ get ();
void set (SqlCeConnection^ value);
}
member Connection : SqlCeConnection with get, set
function get Connection () : SqlCeConnection
function set Connection (value : SqlCeConnection)
Valor da propriedade
Tipo: System.Data.SqlServerCe.SqlCeConnection
A conexão com uma fonte de dados. O valor padrão é nulluma referência nula (Nothing no Visual Basic).
Exceções
| Exceção | Condição |
|---|---|
| InvalidOperationException | A propriedade Connection foi alterada enquanto havia uma transação em andamento. |
Comentários
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. 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 nulluma referência nula (Nothing no Visual Basic), uma InvalidOperationException será gerada. Se a propriedade Transaction for diferente de nulluma referência nula (Nothing no Visual Basic) e a transação já tiver sido confirmada ou revertida, Transaction será definida como nulluma referência nula (Nothing no Visual Basic).
Exemplos
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;