SqlCeDataReader.Seek Method

Coloca SqlCeDataReader en el registro con valores indizados que coinciden con los parámetros especificados.

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

Sintaxis

'Declaración
Public Function Seek ( _
    dbSeekOptions As DbSeekOptions, _
    ParamArray index As Object() _
) As Boolean

public bool Seek (
    DbSeekOptions dbSeekOptions,
    params Object[] index
)

public:
bool Seek (
    DbSeekOptions dbSeekOptions, 
    ... array<Object^>^ index
)

public boolean Seek (
    DbSeekOptions dbSeekOptions, 
    Object[] index
)

public function Seek (
    dbSeekOptions : DbSeekOptions, 
    ... index : Object[]
) : boolean

Parámetros

• dbSeekOptions
  DbSeekOptions que se va a utilizar.

• index
  Índice del registro.

Valor devuelto

Un valor Boolean; true indica que el cursor está situado en una fila.

Excepciones

Notas

Este método constituye una opción más rápida que una instrucción SELECT para recuperar una fila de una tabla base. En lugar de utilizar una cláusula WHERE en una instrucción SELECT, Seek puede utilizarse para recuperar con rapidez una fila basándose en su valor de índice. Por ejemplo, para recuperar un empleado con un Id. de empleado de 5, puede ejecutarse una instrucción SELECT, pero si se utiliza Seek con un valor de 5 en el índice de Id. de empleado, el rendimiento mejorará significativamente.

Seek sólo puede utilizarse si CommandType está establecido en TableDirect, CommandText está establecido en un nombre válido de tabla base y IndexName está establecido en un nombre válido de índice de la tabla base especificada.

Después de utilizar Seek, SqlCeDataReader devolverá las filas restantes en su orden de índice. Si Seek se utiliza en un SqlCeDataReader que tiene un intervalo especificado por SetRange, Seek sólo se coloca en las filas del intervalo especificado. Para obtener más información, vea el tema "IRowsetIndex::Seek" en la documentación de OLE DB.

Ejemplo

Try
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandType = CommandType.TableDirect
    cmd.IndexName = "Orders_PK"
    cmd.CommandText = "Orders"

    ' We are interested in orders that match Order ID = 10020
    '
    cmd.SetRange(DbRangeOptions.Match, New Object() {10020}, Nothing)

    Dim reader As SqlCeDataReader = cmd.ExecuteReader(CommandBehavior.Default)

    While reader.Read()
        MessageBox.Show(String.Format("{0} ; {1}", reader("Order ID"), reader("Order Date")))
    End While

    ' Now we are interested in orders with Order ID between (10020, 10050)
    '
    cmd.SetRange(DbRangeOptions.InclusiveStart Or DbRangeOptions.InclusiveEnd, New Object() {10020}, New Object() {10050})

    reader = cmd.ExecuteReader(CommandBehavior.Default)

    ' Now seek to Order ID = 10045
    '
    Dim onRow As Boolean =  reader.Seek(DbSeekOptions.FirstEqual, New Object() {10045})

    ' Now ,the reader will return rows with Order ID >= 10045 <= 10050
    ' because the range was set to (10020, 10050)
    '
    If onRow Then
        While reader.Read()
            MessageBox.Show(String.Format("{0} ; {1}", reader("Order ID"), reader("Order Date")))
        End While
    End If
Catch e As Exception
    MessageBox.Show(e.Message)
End Try

try
{
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandType = CommandType.TableDirect;
    cmd.IndexName = "Orders_PK";
    cmd.CommandText = "Orders";

    // We are interested in orders that match Order ID = 10020
    //
    cmd.SetRange(DbRangeOptions.Match, new object[] { 10020 }, null);

    SqlCeDataReader reader = cmd.ExecuteReader(CommandBehavior.Default);

    for (int i = 1; reader.Read(); i++)
    {
        MessageBox.Show(String.Format("{0} ; {1}", reader["Order ID"], reader["Order Date"]));
    }

    // Now we are interested in orders with Order ID between (10020, 10050)
    //
    cmd.SetRange(DbRangeOptions.InclusiveStart | DbRangeOptions.InclusiveEnd,
        new object[] { 10020 }, new object[] { 10050 });

    reader = cmd.ExecuteReader(CommandBehavior.Default);

    // Now seek to Order ID = 10045
    //
    bool onRow = reader.Seek(DbSeekOptions.FirstEqual, new object[] { 10045 });

    // Now ,the reader will return rows with Order ID >= 10045 <= 10050
    // because the range was set to (10020, 10050)
    //
    if (onRow)
    {
        for (int i = 1; reader.Read(); i++)
        {
            MessageBox.Show(String.Format("{0} ; {1}", reader["Order ID"], reader["Order Date"]));
        }
    }
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}

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

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace