Método SqlCeResultSet.ReadAbsolute

Artigo
05/27/2011

Move o leitor para um registro especificado no ResultSet.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Function ReadAbsolute ( _
    position As Integer _
) As Boolean
'Uso
Dim instance As SqlCeResultSet
Dim position As Integer
Dim returnValue As Boolean

returnValue = instance.ReadAbsolute(position)

public bool ReadAbsolute(
    int position
)

public:
bool ReadAbsolute(
    int position
)

member ReadAbsolute : 
        position:int -> bool

public function ReadAbsolute(
    position : int
) : boolean

Parâmetros

position
Tipo: System.Int32
A posição para a qual o leitor deve ser movido.

Valor de retorno

Tipo: System.Boolean
True se a operação tiver êxito; caso contrário, false.

Comentários

ReadAbsolute tem base 0; chamar ReadAbsolute(0) retornará a primeira linha do ResultSet.

Este método lê o valor da linha com base na posição da linha salva por um indicador. Por exemplo, suponha uma tabela com 10 linhas, e você abre dois ResultSets: rs1 e rs2. Você chama ReadAbsolue(5) em rs1 e altera o valor dessa linha para -1. Agora, a posição da linha mudou para a primeira posição na lista de linhas e a linha 4 está na quinta posição. Entretanto, se agora você chamar ReadAbsolute(5) em rs2, será retornado um valor -1. ResultSet rs2 mantém um indicador para a quinta linha original e continua a ler essa linha, independentemente da alteração de sua posição.

Se você passar um inteiro positivo para essa função, o leitor será movido do primeiro registro para frente pelo número de registros especificado. Se você passar um inteiro negativo para essa função, o leitor será movido do último registro para trás pelo número de registros especificado.

Exemplos

O exemplo a seguir cria um objeto ResultSet e chama vários métodos, incluindo ReadAbsolute.

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT)"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    ' Insert 10 records
    '
    Dim i As Integer
    For i = 0 To 9
        rec.SetInt32(0, i)
        rs.Insert(rec)
    Next i

    ' Scroll through the results
    '
    If True = rs.ReadFirst() Then
        MessageBox.Show("col1 = " & rs.GetInt32(0)) 'ordinal
    End If

    If True = rs.ReadRelative(5) Then
        MessageBox.Show("col1 = " & rs.GetInt32(0)) 'ordinal
    End If

    If True = rs.ReadLast() Then
        MessageBox.Show("col1 = " & rs.GetInt32(0)) 'ordinal
    End If

    If True = rs.ReadPrevious() Then
        MessageBox.Show("col1 = " & rs.GetInt32(0)) 'ordinal
    End If

    If True = rs.ReadAbsolute(5) Then
        MessageBox.Show("col1 = " & rs.GetInt32(0)) 'ordinal
    End If
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT)";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable | 
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    // Insert 10 records
    //
    for (int i = 0; i < 10; i++)
    {
        rec.SetInt32(0, i);
        rs.Insert(rec);
    }

    // Scroll through the results
    //
    if (true == rs.ReadFirst())
    {
        MessageBox.Show("col1 = " + rs.GetInt32(0 /*ordinal*/));
    }

    if (true == rs.ReadRelative(5))
    {
        MessageBox.Show("col1 = " + rs.GetInt32(0 /*ordinal*/));
    }

    if (true == rs.ReadLast())
    {
        MessageBox.Show("col1 = " + rs.GetInt32(0 /*ordinal*/));
    }

    if (true == rs.ReadPrevious())
    {
        MessageBox.Show("col1 = " + rs.GetInt32(0 /*ordinal*/));
    }

    if (true == rs.ReadAbsolute(5))
    {
        MessageBox.Show("col1 = " + rs.GetInt32(0 /*ordinal*/));
    }
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    conn.Close();
}

Consulte também

Referência

SqlCeResultSet Classe

Namespace System.Data.SqlServerCe

Compartilhar via