Método SqlCeCommand.ExecuteReader (CommandBehavior)
Envia CommandText a Connection e cria SqlCeDataReader usando um dos valores de CommandBehavior.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
Public Function ExecuteReader ( _
behavior As CommandBehavior _
) As SqlCeDataReader
'Uso
Dim instance As SqlCeCommand
Dim behavior As CommandBehavior
Dim returnValue As SqlCeDataReader
returnValue = instance.ExecuteReader(behavior)
public SqlCeDataReader ExecuteReader(
CommandBehavior behavior
)
public:
SqlCeDataReader^ ExecuteReader(
CommandBehavior behavior
)
member ExecuteReader :
behavior:CommandBehavior -> SqlCeDataReader
public function ExecuteReader(
behavior : CommandBehavior
) : SqlCeDataReader
Parâmetros
- behavior
Tipo: System.Data.CommandBehavior
Um dos valores de CommandBehavior.
Valor de retorno
Tipo: System.Data.SqlServerCe.SqlCeDataReader
Um objeto SqlCeDataReader.
Exceções
| Exceção | Condição |
|---|---|
| InvalidOperationException | Não é possível executar um comando com um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente. |
Comentários
O SqlCeDataReader dá suporte a um modo especial que permite a leitura eficiente de valores binários grandes. Para obter mais informações, consulte a configuração SequentialAccess para CommandBehavior.
Enquanto o SqlCeDataReader está sendo usado, a SqlCeConnection associada está ocupada atendendo o SqlCeDataReader. Neste estado, antes de chamar o método Close do SqlCeDataReader, você pode executar apenas a operação Close na SqlCeConnection.
Exemplos
O exemplo a seguir cria um SqlCeCommand e o executa passando uma instrução SQL SELECT e um objeto SqlCeConnection. O CommandBehavior é definido como CloseConnection.
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand("SELECT * FROM myTable", conn)
cmd.Connection.Open()
Dim rdr As SqlCeDataReader = Nothing
Try
' Execute the reader; make sure you alway close the
' reader after you're done using it (ideally in the finally block)
'
rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection)
While rdr.Read()
Console.WriteLine(rdr.GetString(0))
End While
Finally
' Closing the reader will also close the associated connection
'
rdr.Close()
End Try
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand("SELECT * FROM myTable", conn);
cmd.Connection.Open();
SqlCeDataReader rdr = null;
try
{
// Execute the reader; make sure you alway close the
// reader after you're done using it (ideally in the finally block)
//
rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
while (rdr.Read())
{
Console.WriteLine(rdr.GetString(0));
}
}
finally
{
// Closing the reader will also close the associated connection
//
rdr.Close();
}