SqlCeResultSet.ReadAbsolute メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlCeResultSet.ReadAbsolute メソッド

ResultSet 内の特定のレコードにリーダーを移動します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Function ReadAbsolute ( _
    position As Integer _
) As Boolean

Visual Basic (使用法)

Dim instance As SqlCeResultSet
Dim position As Integer
Dim returnValue As Boolean

returnValue = instance.ReadAbsolute(position)

public bool ReadAbsolute (
    int position
)

C++

public:
bool ReadAbsolute (
    int position
)

public boolean ReadAbsolute (
    int position
)

JScript

public function ReadAbsolute (
    position : int
) : boolean

パラメータ

position: リーダーの移動先の位置。

戻り値
正常に操作できた場合は true。それ以外の場合は false。

解説

ReadAbsolute は 0 から始まります。ReadAbsolute(0) を呼び出すと、ResultSet の最初の行が返されます。

このメソッドでは、ブックマークで保存された行の位置に基づいて、行の値が読み取られます。たとえば、10 行が含まれるテーブルで、2 つの ResultSet、rs1 と rs2 を開くとします。rs1 に対して ReadAbsolue(5) を呼び出し、この行の値を -1 に変更します。この行の位置が、行リストの先頭の位置に変更され、4 行目が 5 行目になります。ただし、rs2 に対して ReadAbsolute(5) を呼び出すと、-1 が返されます。 ResultSet rs2 では、ブックマークが元の 5 行目のまま維持されており、位置が変更されても、引き続きその行が読み取られます。

この関数に正の整数を渡すと、リーダーが最初のレコードから、指定した数のレコード分だけ前に移動します。この関数に負の整数を渡すと、リーダーが最後のレコードから、指定した数のレコード分だけ後ろに移動します。

使用例

ResultSet オブジェクトを作成して、ReadAbsolute など、複数のメソッドを呼び出す例を次に示します。

Visual Basic

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