IResultSet インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データベースの結果セットを表すデータのテーブル。通常は、データベースにクエリを実行するステートメントを実行して生成されます。
[Android.Runtime.Register("java/sql/ResultSet", "", "Java.Sql.IResultSetInvoker")]
public interface IResultSet : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper[<Android.Runtime.Register("java/sql/ResultSet", "", "Java.Sql.IResultSetInvoker")>]
type IResultSet = interface
interface IWrapper
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 派生
- 属性
- 実装
注釈
データベースの結果セットを表すデータのテーブル。通常は、データベースにクエリを実行するステートメントを実行して生成されます。
ResultSet オブジェクトは、現在のデータ行を指すカーソルを保持します。 最初、カーソルは最初の行の前に配置されます。
next メソッドはカーソルを次の行に移動し、ResultSet オブジェクトに行がなくなったときにfalseを返すので、while ループで結果セットを反復処理するために使用できます。
既定の ResultSet オブジェクトは更新可能ではなく、前方にのみ移動するカーソルがあります。 したがって、最初の行から最後の行まで、1 回だけ反復処理できます。 スクロール可能または更新可能な ResultSet オブジェクトを生成できます。 次のコード フラグメントは、 con が有効な Connection オブジェクトであり、他のユーザーによる更新に対してスクロール可能で、かつ更新可能な結果セットを作成する方法を示しています。 その他のオプションについては、 ResultSet フィールドを参照してください。
Statement stmt = con.createStatement(
ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2");
// rs will be scrollable, will not show changes made by others,
// and will be updatable
ResultSet インターフェイスには、現在の行から列値を取得するための getter メソッド (getBoolean、getLongなど) が用意されています。 値は、列のインデックス番号または列の名前を使用して取得できます。 一般に、列インデックスを使用する方が効率的です。 列は、連番が 1 から振られます。 移植性を最大限に高めるために、各行内の結果セット列を左から右の順序で読み取り、各列を 1 回だけ読み取る必要があります。
getter メソッドの場合、JDBC ドライバーは、基になるデータを getter メソッドで指定されたJava型に変換しようと試み、適切なJava値を返します。 JDBC 仕様には、sql 型から ResultSet getter メソッドで使用できるJava型への許容可能なマッピングを示すテーブルがあります。
getter メソッドの入力として使用される列名では、大文字と小文字が区別されません。 getter メソッドが列名で呼び出され、複数の列の名前が同じである場合、最初に一致する列の値が返されます。 列名オプションは、結果セットを生成した SQL クエリで列名を使用するときに使用するように設計されています。 クエリで明示的に名前が付けられない列の場合は、列番号を使用することをお勧めします。 列名を使用する場合、プログラマは、SQL AS 句で保証できる目的の列を一意に参照するように注意する必要があります。
このインターフェイスには、JDBC 2.0 API (Java<sup><font size=-2>TM</font></sup> 2 SDK、Standard Edition、バージョン 1.2) のアップデーター メソッドのセットが追加されました。 getter メソッドのパラメーターに関するコメントは、アップデーター メソッドのパラメーターにも適用されます。
アップデーターメソッドは、現在の行の列値を更新するために <ol><LI>の2つの方法で使用できます。 スクロール可能な ResultSet オブジェクトでは、カーソルを前後、絶対位置、または現在の行を基準とした位置に移動できます。 次のコード フラグメントは、ResultSet オブジェクト rsの 5 行目のNAME列を更新し、メソッド updateRowを使用して、rsの派生元のデータ ソース テーブルを更新します。
rs.absolute(5); // moves the cursor to the fifth row of rs
rs.updateString("NAME", "AINSWORTH"); // updates the
// <code>NAME</code> column of row 5 to be <code>AINSWORTH</code>
rs.updateRow(); // updates the row in the data source
<LI>列の値を挿入行に挿入します。 更新可能な ResultSet オブジェクトには、挿入する行を作成するためのステージング領域として機能する特殊な行が関連付けられています。 次のコード フラグメントは、カーソルを挿入行に移動し、3 列の行をビルドし、メソッド insertRowを使用してrsおよびデータ ソース テーブルに挿入します。
rs.moveToInsertRow(); // moves cursor to the insert row
rs.updateString(1, "AINSWORTH"); // updates the
// first column of the insert row to be <code>AINSWORTH</code>
rs.updateInt(2,35); // updates the second column to be <code>35</code>
rs.updateBoolean(3, true); // updates the third column to <code>true</code>
rs.insertRow();
rs.moveToCurrentRow();
</ol>
ResultSet オブジェクトは、生成されたStatement オブジェクトが閉じられたり、再実行されたり、複数の結果のシーケンスから次の結果を取得するために使用されたりすると、自動的に閉じられます。
ResultSet オブジェクトの列の数、型、およびプロパティは、ResultSet.getMetaData メソッドによって返されるResultSetMetaData オブジェクトによって提供されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
フィールド
| 名前 | 説明 |
|---|---|
| CloseCursorsAtCommit |
現在のトランザクションがコミットされると、この保持性を持つ開いている |
| ConcurReadOnly |
更新できない可能性がある |
| ConcurUpdatable |
更新可能な |
| FetchForward |
結果セット内の行が前方方向に処理されることを示す定数。first-to-last。 |
| FetchReverse |
結果セット内の行が逆方向に処理されることを示す定数。last-to-first。 |
| FetchUnknown |
結果セット内の行の処理順序が不明であることを示す定数。 |
| HoldCursorsOverCommit |
この保持性を持つオブジェクト |
| TypeForwardOnly |
カーソルが前方にのみ移動する可能性がある |
| TypeScrollInsensitive |
スクロール可能な |
| TypeScrollSensitive |
スクロール可能で、一般的に |
プロパティ
| 名前 | 説明 |
|---|---|
| Concurrency |
この |
| CursorName |
この |
| FetchDirection |
この |
| FetchSize |
この |
| Handle |
基になる Android オブジェクトの JNI 値を取得します。 (継承元 IJavaObject) |
| Holdability |
この結果セットの保持可能性 ( HoldCursorsOverCommit または CloseCursorsAtCommit) を返します。 |
| IsAfterLast |
カーソルが |
| IsBeforeFirst |
カーソルが |
| IsClosed |
この結果セットが閉じている場合は true、それ以外の場合は false を返します。 |
| IsFirst |
カーソルが |
| IsLast |
カーソルが最後の行にあるかどうかを取得します。 |
| JniIdentityHashCode |
ラップされたインスタンスの |
| JniManagedPeerState |
マネージド ピアの状態。 (継承元 IJavaPeerable) |
| JniObjectReferenceControlBlock |
データベースの結果セットを表すデータのテーブル。通常は、データベースにクエリを実行するステートメントを実行して生成されます。 (継承元 IJavaPeerable) |
| JniPeerMembers |
メンバー アクセスと呼び出しのサポート。 (継承元 IJavaPeerable) |
| MetaData |
この |
| PeerReference |
ラップされたJava オブジェクト インスタンスのJniObjectReferenceを返します。 (継承元 IJavaPeerable) |
| Row |
|
| Statement |
この |
| Type |
|
| Warnings |
この |
メソッド
| 名前 | 説明 |
|---|---|
| Absolute(Int32) |
この |
| AfterLast() |
カーソルをこの |
| BeforeFirst() |
カーソルを、この |
| CancelRowUpdates() |
この |
| ClearWarnings() |
この |
| Close() |
この |
| DeleteRow() |
この |
| Disposed() |
インスタンスが破棄されたときに呼び出されます。 (継承元 IJavaPeerable) |
| DisposeUnlessReferenced() |
このインスタンスへの未処理の参照がない場合は、 |
| Finalized() |
インスタンスが終了したときに呼び出されます。 (継承元 IJavaPeerable) |
| FindColumn(String) |
指定した |
| First() |
カーソルを、この |
| GetArray(Int32) |
この |
| GetArray(String) |
この |
| GetAsciiStream(Int32) |
この |
| GetAsciiStream(String) |
この |
| GetBigDecimal(Int32, Int32) |
古い.
この |
| GetBigDecimal(Int32) |
この |
| GetBigDecimal(String, Int32) |
古い.
この |
| GetBigDecimal(String) |
この |
| GetBinaryStream(Int32) |
この |
| GetBinaryStream(String) |
この |
| GetBlob(Int32) |
この |
| GetBlob(String) |
この |
| GetBoolean(Int32) |
この |
| GetBoolean(String) |
この |
| GetByte(Int32) |
この |
| GetByte(String) |
この |
| GetBytes(Int32) |
この |
| GetBytes(String) |
この |
| GetCharacterStream(Int32) |
この |
| GetCharacterStream(String) |
この |
| GetClob(Int32) |
この |
| GetClob(String) |
この |
| GetDate(Int32, Calendar) |
この |
| GetDate(Int32) |
この |
| GetDate(String, Calendar) |
この |
| GetDate(String) |
この |
| GetDouble(Int32) |
この |
| GetDouble(String) |
この |
| GetFloat(Int32) |
この |
| GetFloat(String) |
この |
| GetInt(Int32) |
この |
| GetInt(String) |
この |
| GetLong(Int32) |
この |
| GetLong(String) |
この |
| GetNCharacterStream(Int32) |
この |
| GetNCharacterStream(String) |
この |
| GetNClob(Int32) |
この |
| GetNClob(String) |
この |
| GetNString(Int32) |
この |
| GetNString(String) |
この |
| GetObject(Int32, IDictionary<String,Class>) |
この |
| GetObject(Int32) |
この |
| GetObject(String, IDictionary<String,Class>) |
この |
| GetObject(String) |
この |
| GetRef(Int32) |
この |
| GetRef(String) |
この |
| GetRowId(Int32) |
この |
| GetRowId(String) |
この |
| GetShort(Int32) |
この |
| GetShort(String) |
この |
| GetSQLXML(Int32) |
この |
| GetSQLXML(String) |
この |
| GetString(Int32) |
この |
| GetString(String) |
この |
| GetTime(Int32, Calendar) |
この |
| GetTime(Int32) |
この |
| GetTime(String, Calendar) |
この |
| GetTime(String) |
この |
| GetTimestamp(Int32, Calendar) |
この |
| GetTimestamp(Int32) |
この |
| GetTimestamp(String, Calendar) |
この |
| GetTimestamp(String) |
この |
| GetUnicodeStream(Int32) |
古い.
この |
| GetUnicodeStream(String) |
古い.
この |
| GetURL(Int32) |
この |
| GetURL(String) |
この |
| InsertRow() |
挿入行の内容を、この |
| IsWrapperFor(Class) |
インターフェイス引数を実装する場合、または直接または間接的に行うオブジェクトのラッパーである場合は true を返します。 (継承元 IWrapper) |
| Last() |
カーソルを、この |
| MoveToCurrentRow() |
記憶されているカーソル位置 (通常は現在の行) にカーソルを移動します。 |
| MoveToInsertRow() |
カーソルを挿入行に移動します。 |
| Next() |
カーソルを現在の位置から 1 行ずつ移動します。 |
| Previous() |
この |
| RefreshRow() |
データベース内の最新の値で現在の行を更新します。 |
| Relative(Int32) |
カーソルを、正または負の行の相対数で移動します。 |
| RowDeleted() |
行が削除されたかどうかを取得します。 |
| RowInserted() |
現在の行に挿入があったかどうかを取得します。 |
| RowUpdated() |
現在の行が更新されたかどうかを取得します。 |
| SetJniIdentityHashCode(Int32) |
|
| SetJniManagedPeerState(JniManagedPeerStates) |
データベースの結果セットを表すデータのテーブル。通常は、データベースにクエリを実行するステートメントを実行して生成されます。 (継承元 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
|
| UnregisterFromRuntime() |
ランタイムが将来の Java.Interop.JniRuntime+JniValueManager.PeekValue 呼び出しから返されないように、このインスタンスの登録を解除します。 (継承元 IJavaPeerable) |
| Unwrap(Class) |
指定されたインターフェイスを実装して、標準以外のメソッドまたはプロキシによって公開されていない標準メソッドへのアクセスを許可するオブジェクトを返します。 (継承元 IWrapper) |
| UpdateArray(Int32, IArray) |
指定された列を |
| UpdateArray(String, IArray) |
指定された列を |
| UpdateAsciiStream(Int32, Stream, Int32) |
指定された列を、指定されたバイト数の ascii ストリーム値で更新します。 |
| UpdateAsciiStream(Int32, Stream, Int64) |
指定された列を、指定されたバイト数の ascii ストリーム値で更新します。 |
| UpdateAsciiStream(Int32, Stream) |
指定された列を ascii ストリーム値で更新します。 |
| UpdateAsciiStream(String, Stream, Int32) |
指定された列を、指定されたバイト数の ascii ストリーム値で更新します。 |
| UpdateAsciiStream(String, Stream, Int64) |
指定された列を、指定されたバイト数の ascii ストリーム値で更新します。 |
| UpdateAsciiStream(String, Stream) |
指定された列を ascii ストリーム値で更新します。 |
| UpdateBigDecimal(Int32, BigDecimal) |
指定された列を |
| UpdateBigDecimal(String, BigDecimal) |
指定された列を |
| UpdateBinaryStream(Int32, Stream, Int32) |
指定された列をバイナリ ストリーム値で更新します。この値は、指定されたバイト数になります。 |
| UpdateBinaryStream(Int32, Stream, Int64) |
指定された列をバイナリ ストリーム値で更新します。この値は、指定されたバイト数になります。 |
| UpdateBinaryStream(Int32, Stream) |
指定された列をバイナリ ストリーム値で更新します。 |
| UpdateBinaryStream(String, Stream, Int32) |
指定された列をバイナリ ストリーム値で更新します。この値は、指定されたバイト数になります。 |
| UpdateBinaryStream(String, Stream, Int64) |
指定された列をバイナリ ストリーム値で更新します。この値は、指定されたバイト数になります。 |
| UpdateBinaryStream(String, Stream) |
指定された列をバイナリ ストリーム値で更新します。 |
| UpdateBlob(Int32, IBlob) |
指定された列を |
| UpdateBlob(Int32, Stream, Int64) |
指定した入力ストリームを使用して、指定された列を更新します。指定されたバイト数になります。 |
| UpdateBlob(Int32, Stream) |
指定された入力ストリームを使用して、指定された列を更新します。 |
| UpdateBlob(String, IBlob) |
指定された列を |
| UpdateBlob(String, Stream, Int64) |
指定した入力ストリームを使用して、指定された列を更新します。指定されたバイト数になります。 |
| UpdateBlob(String, Stream) |
指定された入力ストリームを使用して、指定された列を更新します。 |
| UpdateBoolean(Int32, Boolean) |
指定された列を |
| UpdateBoolean(String, Boolean) |
指定された列を |
| UpdateByte(Int32, SByte) |
指定された列を |
| UpdateByte(String, SByte) |
指定された列を |
| UpdateBytes(Int32, Byte[]) |
指定された列を |
| UpdateBytes(String, Byte[]) |
指定された列をバイト配列値で更新します。 |
| UpdateCharacterStream(Int32, Reader, Int32) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateCharacterStream(Int32, Reader, Int64) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateCharacterStream(Int32, Reader) |
指定された列を文字ストリーム値で更新します。 |
| UpdateCharacterStream(String, Reader, Int32) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateCharacterStream(String, Reader, Int64) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateCharacterStream(String, Reader) |
指定された列を文字ストリーム値で更新します。 |
| UpdateClob(Int32, IClob) |
指定された列を |
| UpdateClob(Int32, Reader, Int64) |
指定した |
| UpdateClob(Int32, Reader) |
指定された |
| UpdateClob(String, IClob) |
指定された列を |
| UpdateClob(String, Reader, Int64) |
指定した |
| UpdateClob(String, Reader) |
指定された |
| UpdateDate(Int32, Date) |
指定された列を |
| UpdateDate(String, Date) |
指定された列を |
| UpdateDouble(Int32, Double) |
指定された列を |
| UpdateDouble(String, Double) |
指定された列を |
| UpdateFloat(Int32, Single) |
指定された列を |
| UpdateFloat(String, Single) |
指定された列を |
| UpdateInt(Int32, Int32) |
指定された列を |
| UpdateInt(String, Int32) |
指定された列を |
| UpdateLong(Int32, Int64) |
指定された列を |
| UpdateLong(String, Int64) |
指定された列を |
| UpdateNCharacterStream(Int32, Reader, Int64) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateNCharacterStream(Int32, Reader) |
指定された列を文字ストリーム値で更新します。 |
| UpdateNCharacterStream(String, Reader, Int64) |
指定された列を、指定されたバイト数の文字ストリーム値で更新します。 |
| UpdateNCharacterStream(String, Reader) |
指定された列を文字ストリーム値で更新します。 |
| UpdateNClob(Int32, INClob) |
指定された列を |
| UpdateNClob(Int32, Reader, Int64) |
指定した |
| UpdateNClob(Int32, Reader) |
指定された列を使用して、指定された列を更新します。 |
| UpdateNClob(String, INClob) |
指定された列を |
| UpdateNClob(String, Reader, Int64) |
指定した |
| UpdateNClob(String, Reader) |
指定された |
| UpdateNString(Int32, String) |
指定された列を |
| UpdateNString(String, String) |
指定された列を |
| UpdateNull(Int32) |
指定された列を |
| UpdateNull(String) |
指定された列を |
| UpdateObject(Int32, Object, Int32) |
指定された列を |
| UpdateObject(Int32, Object) |
指定された列を |
| UpdateObject(String, Object, Int32) |
指定された列を |
| UpdateObject(String, Object) |
指定された列を |
| UpdateRef(Int32, IRef) |
指定された列を |
| UpdateRef(String, IRef) |
指定された列を |
| UpdateRow() |
基になるデータベースを、この |
| UpdateRowId(Int32, IRowId) |
指定された列を |
| UpdateRowId(String, IRowId) |
指定された列を |
| UpdateShort(Int32, Int16) |
指定された列を |
| UpdateShort(String, Int16) |
指定された列を |
| UpdateSQLXML(Int32, ISQLXML) |
指定された列を |
| UpdateSQLXML(String, ISQLXML) |
指定された列を |
| UpdateString(Int32, String) |
指定された列を |
| UpdateString(String, String) |
指定された列を |
| UpdateTime(Int32, Time) |
指定された列を |
| UpdateTime(String, Time) |
指定された列を |
| UpdateTimestamp(Int32, Timestamp) |
指定された列を |
| UpdateTimestamp(String, Timestamp) |
指定された列を |
| WasNull() |
最後に読み取られた列の値が SQL |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
データベースの結果セットを表すデータのテーブル。通常は、データベースにクエリを実行するステートメントを実行して生成されます。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|