SqlCeResultSet.ReadAbsolute-Methode

Verschiebt den Reader zu einem bestimmten Datensatz im ResultSet.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Function ReadAbsolute ( _
    position As Integer _
) As Boolean
'Usage
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
)

public boolean ReadAbsolute (
    int position
)

public function ReadAbsolute (
    position : int
) : boolean

Parameter

• position
  Die Position, an die der Reader verschoben werden soll.

Rückgabewert

True, wenn der Vorgang erfolgreich war, andernfalls False.

Hinweise

Die ReadAbsolute-Methode ist nullbasiert. Das Aufrufen von ReadAbsolute(0) gibt die erste Zeile von ResultSet zurück.

Diese Methode liest den Wert der Zeile basierend auf der durch das Lesezeichen gespeicherten Zeilenposition. Beispielsweise werden in einer Tabelle mit 10 Zeilen zwei ResultSets geöffnet: rs1 und rs2. ReadAbsolue(5) wird für rs1 aufgerufen und ändert den Wert dieser Zeile auf -1. Die Zeile steht nun in der Liste der Zeilen an erster Stelle, und Zeile 4 befindet sich an fünfter Stelle. Wenn nun jedoch ReadAbsolute(5) für rs2 aufgerufen wird, wird ein Wert von -1 zurückgegeben. ResultSet rs2 behält ein Lesezeichen zur ursprünglich fünften Zeile bei und liest trotz der Positionsveränderung immer diese Zeile.

Wenn eine positive Ganzzahl an diese Funktion übergeben wird, wird der Reader vom ersten Datensatz um die angegebene Anzahl von Datensätzen nach vorne verschoben. Wenn eine negative Ganzzahl an diese Funktion übergeben wird, wird der Reader vom letzten Datensatz um die angegebene Anzahl von Datensätzen nach hinten verschoben.

Beispiel

Im folgenden Beispiel wird ein ResultSet-Objekt erstellt, und es werden anschließend mehrere Methoden aufgerufen, einschließlich der ReadAbsolute-Methode.

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

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

SqlCeResultSet-Klasse
SqlCeResultSet-Member
System.Data.SqlServerCe-Namespace