SqlCeCommand.SetRange Método

Restringe el conjunto de filas que SqlCeDataReader va a leer.

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

Sintaxis

'Declaración
Public Sub SetRange ( _
    dbRangeOptions As DbRangeOptions, _
    startData As Object(), _
    endData As Object() _
)
'Uso
Dim instance As SqlCeCommand
Dim dbRangeOptions As DbRangeOptions
Dim startData As Object()
Dim endData As Object()

instance.SetRange(dbRangeOptions, startData, _
    endData)

public void SetRange(
    DbRangeOptions dbRangeOptions,
    Object[] startData,
    Object[] endData
)

public:
void SetRange(
    DbRangeOptions dbRangeOptions, 
    array<Object^>^ startData, 
    array<Object^>^ endData
)

member SetRange : 
        dbRangeOptions:DbRangeOptions * 
        startData:Object[] * 
        endData:Object[] -> unit 

public function SetRange(
    dbRangeOptions : DbRangeOptions, 
    startData : Object[], 
    endData : Object[]
)

Parámetros

• dbRangeOptions
  Tipo: System.Data.SqlServerCe.DbRangeOptions
  Opciones utilizadas al especificar el intervalo.

• startData
  Tipo: array<System.Object[]
  Valores clave de inicio del intervalo.

• endData
  Tipo: array<System.Object[]
  Valores clave finales del intervalo.

Excepciones

Excepción	Condición
InvalidOperationException	No se ha establecido la propiedad IndexName.

Comentarios

Este método constituye una opción más rápida que una instrucción SELECT para recuperar un conjunto de filas de una tabla base. En lugar de utilizar una cláusula WHERE en una instrucción SELECT, SetRange puede utilizarse para recuperar con rapidez un conjunto de filas basándose en sus valores de índice. Por ejemplo, para recuperar un conjunto de empleados con un Id. de empleado comprendido entre 1 y 5, puede ejecutarse una instrucción SELECT, pero si se establece un intervalo de 1 a 5 en el índice de Id de empleado, el rendimiento mejorará significativamente.

Este método sólo puede utilizarse si CommandType está establecido en TableDirect, CommandText está establecido en un nombre de tabla base válido y IndexName está establecido en un nombre de índice válido de la tabla base especificada. Si se utiliza SetRange, el SqlCeDataReader devuelto a partir de ExecuteReader sólo devuelve las filas cuyos valores de clave en el índice especificado coinciden con el intervalo.

Si se utiliza Seek en un SqlCeDataReader que tiene un intervalo, Seek sólo se situará en las filas del intervalo especificado. Para obtener información detallada acerca de SetRange, vea el tema "IRowsetIndex::SetRange" en la documentación de OLE DB.

Ejemplos

Este ejemplo recupera los datos de la tabla Orders utilizando un índice de SqlCeDataReader. El intervalo del índice en el que opera el método Seek se especifica mediante el método SetRange.

        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);
        }

Vea también

Referencia

SqlCeCommand Clase

Espacio de nombres System.Data.SqlServerCe