Compartir a través de

SqlCeCommand.ExecuteReader Method (CommandBehavior)

  • Artículo

Envía la propiedad CommandText al objeto Connection y crea un objeto SqlCeDataReader mediante uno de los valores de CommandBehavior.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
Public Function ExecuteReader ( _
    behavior As CommandBehavior _
) As SqlCeDataReader

public SqlCeDataReader ExecuteReader (
    CommandBehavior behavior
)

public:
SqlCeDataReader^ ExecuteReader (
    CommandBehavior behavior
)

public SqlCeDataReader ExecuteReader (
    CommandBehavior behavior
)

public function ExecuteReader (
    behavior : CommandBehavior
) : SqlCeDataReader

Parámetros

Valor devuelto

Objeto SqlCeDataReader.

Excepciones

Tipo de excepción Condición
InvalidOperationException

No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se dio de alta la conexión originalmente.

Notas

SqlCeDataReader admite un modo especial que permite que los valores binarios grandes se lean eficazmente. Para obtener más información, vea el valor de SequentialAccess para CommandBehavior.

Mientras se utiliza SqlCeDataReader, la interfaz SqlCeConnection asociada está ocupada atendiendo a SqlCeDataReader. En este estado, hasta que no se llame al método Close de SqlCeDataReader, sólo se podrá realizar la operación Close en SqlCeConnection.

Ejemplo

En el ejemplo siguiente se crea un objeto SqlCeCommand y a continuación se ejecuta, pasando una instrucción SELECT de SQL y un objeto SqlCeConnection. CommandBehavior se establece en 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();
}

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace