java.sql
介面 ResultSet

所有父級介面：

Wrapper

所有已知子介面：

CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet

public interface ResultSet
extends Wrapper

表示資料庫結果集的資料表，通常通過執行查詢資料庫的語句產生。

ResultSet 物件具有指向其當前資料行的鼠標。最初，鼠標被置於第一行之前。next 方法將鼠標移動到下一行；因為該方法在 ResultSet 物件沒有下一行時返回 false，所以可以在 while 循環中使用它來迭代結果集。

預設的 ResultSet 物件不可更新，僅有一個向前移動的鼠標。因此，只能迭代它一次，並且只能按從第一行到最後一行的順序進行。可以產生可滾動和/或可更新的 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 介面提供用於從當前行獲取列值的獲取 方法（getBoolean、getLong 等）。可以使用列的索引編號或列的名稱獲取值。一般情況下，使用列索引較為高效。列從 1 開始編號。為了獲得最大的可移植性，應該按從左到右的順序讀取每行中的結果集列，每列只能讀取一次。

對於獲取方法，JDBC 驅動程序嘗試將底層資料轉換為在獲取方法中指定的 Java 型別，並返回適當的 Java 值。JDBC 規範有一個表，顯示允許的從 SQL 型別到 ResultSet 獲取方法所使用的 Java 型別的映射關係。

用作獲取方法的輸入的列名稱不區分大小寫。用列名稱調用獲取方法時，如果多個列具有這一名稱，則返回第一個比對列的值。在產生結果集的 SQL 查詢中使用列名稱時，將使用列名稱選項。對於沒有在查詢中顯式指定的列，最好使用列編號。如果使用列名稱，則開發人員應該注意保證名稱唯一參考預期的列，這可以使用 SQL AS 子句確定。

在 JDBC 2.0 API（Java^TM 2 SDK 標準版 1.2 版）中，此介面添加了一組更新方法。關於獲取方法參數的註釋同樣適用於更新方法的參數。

可以用以下兩種方式使用更新方法：

1. 更新當前行中的列值。在可滾動的 ResultSet 物件中，可以向前和向後移動鼠標，將其置於絕對位置或相對於當前行的位置。以下程式碼片段更新 ResultSet 物件 rs 第五行中的 NAME 列，然後使用方法 updateRow 更新導出 rs 的資料源表。

   
          rs.absolute(5); // moves the cursor to the fifth row of rs
          rs.updateString("NAME", "AINSWORTH"); // updates the 
             // NAME column of row 5 to be AINSWORTH
          rs.updateRow(); // updates the row in the data source
   
    

2. 將列值插入到插入行中。可更新的 ResultSet 物件具有一個與其關聯的特殊行，該行用作建構要插入的行的暫存區域 (staging area)。以下程式碼片段將鼠標移動到插入行，建構一個三列的行，並使用方法 insertRow 將其插入到 rs 和資料源表中。

   
          rs.moveToInsertRow(); // moves cursor to the insert row
          rs.updateString(1, "AINSWORTH"); // updates the 
             // first column of the insert row to be AINSWORTH
          rs.updateInt(2,35); // updates the second column to be 35
          rs.updateBoolean(3, true); // updates the third column to true
          rs.insertRow();
          rs.moveToCurrentRow();
   
    

當產生 ResultSet 物件的 Statement 物件關閉、重新執行或用來從多個結果的序列獲取下一個結果時，ResultSet 物件將自動關閉。

ResultSet 物件的列的編號、型別和屬性由 ResultSet.getMetaData 方法返回的 ResulSetMetaData 物件提供。

另請參見：

Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData

欄位摘要

static int	CLOSE_CURSORS_AT_COMMIT 該常數指示提交當前事務時，具有此可保存性的打開的 ResultSet 物件將被關閉。
static int	CONCUR_READ_ONLY 該常數指示不可以更新的 ResultSet 物件的共時網要。
static int	CONCUR_UPDATABLE 該常數指示可以更新的 ResultSet 物件的共時網要。
static int	FETCH_FORWARD 該常數指示將按正向（即從第一個到最後一個）處理結果集中的行。
static int	FETCH_REVERSE 該常數指示將按逆向（即從最後一個到第一個）處理結果集中的行處理。
static int	FETCH_UNKNOWN 該常數指示結果集中的行的處理順序未知。
static int	HOLD_CURSORS_OVER_COMMIT 該常數指示提交當前事務時，具有此可保存性的打開的 ResultSet 物件將保持開放。
static int	TYPE_FORWARD_ONLY 該常數指示鼠標只能向前移動的 ResultSet 物件的型別。
static int	TYPE_SCROLL_INSENSITIVE 該常數指示可滾動但通常不受 ResultSet 底層資料更改影響的 ResultSet 物件的型別。
static int	TYPE_SCROLL_SENSITIVE 該常數指示可滾動並且通常受 ResultSet 底層資料更改影響的 ResultSet 物件的型別。

方法摘要

boolean	absolute(int row) 將鼠標移動到此 ResultSet 物件的給定行編號。
void	afterLast() 將鼠標移動到此 ResultSet 物件的末尾，正好位於最後一行之後。
void	beforeFirst() 將鼠標移動到此 ResultSet 物件的開頭，正好位於第一行之前。
void	cancelRowUpdates() 取消對 ResultSet 物件中的當前行所作的更新。
void	clearWarnings() 清除在此 ResultSet 物件上報告的所有警告。
void	close() 立即釋放此 ResultSet 物件的資料庫和 JDBC 資源，而不是等待該物件自動關閉時發生此操作。
void	deleteRow() 從此 ResultSet 物件和底層資料庫中刪除當前行。
int	findColumn(String columnLabel) 將給定的 ResultSet 列標籤映射到其 ResultSet 列索引。
boolean	first() 將鼠標移動到此 ResultSet 物件的第一行。
Array	getArray(int columnIndex) 以 Java 程式語言中 Array 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Array	getArray(String columnLabel) 以 Java 程式語言中 Array 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
InputStream	getAsciiStream(int columnIndex) 以 ASCII 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。
InputStream	getAsciiStream(String columnLabel) 以 ASCII 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。
BigDecimal	getBigDecimal(int columnIndex) 以具有全精度的 java.math.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。
BigDecimal	getBigDecimal(int columnIndex, int scale) 已過時。
BigDecimal	getBigDecimal(String columnLabel) 以具有全精度的 java.math.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。
BigDecimal	getBigDecimal(String columnLabel, int scale) 已過時。
InputStream	getBinaryStream(int columnIndex) 以未解釋位元組的串流的形式獲取此 ResultSet 物件的當前行中指定列的值。
InputStream	getBinaryStream(String columnLabel) 以未解釋的 byte 串流的形式獲取此 ResultSet 物件的當前行中指定列的值。
Blob	getBlob(int columnIndex) 以 Java 程式語言中 Blob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Blob	getBlob(String columnLabel) 以 Java 程式語言中 Blob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
boolean	getBoolean(int columnIndex) 以 Java 程式語言中 boolean 的形式獲取此 ResultSet 物件的當前行中指定列的值。
boolean	getBoolean(String columnLabel) 以 Java 程式語言中 boolean 的形式獲取此 ResultSet 物件的當前行中指定列的值。
byte	getByte(int columnIndex) 以 Java 程式語言中 byte 的形式獲取此 ResultSet 物件的當前行中指定列的值。
byte	getByte(String columnLabel) 以 Java 程式語言中 byte 的形式獲取此 ResultSet 物件的當前行中指定列的值。
byte[]	getBytes(int columnIndex) 以 Java 程式語言中 byte 陣列的形式獲取此 ResultSet 物件的當前行中指定列的值。
byte[]	getBytes(String columnLabel) 以 Java 程式語言中 byte 陣列的形式獲取此 ResultSet 物件的當前行中指定列的值。
Reader	getCharacterStream(int columnIndex) 以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Reader	getCharacterStream(String columnLabel) 以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Clob	getClob(int columnIndex) 以 Java 程式語言中 Clob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Clob	getClob(String columnLabel) 以 Java 程式語言中 Clob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getConcurrency() 獲取此 ResultSet 物件的共時網要。
String	getCursorName() 獲取此 ResultSet 物件使用的 SQL 鼠標的名稱。
Date	getDate(int columnIndex) 以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Date	getDate(int columnIndex, Calendar cal) 以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Date	getDate(String columnLabel) 以 Java 程式語言中的 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Date	getDate(String columnLabel, Calendar cal) 以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
double	getDouble(int columnIndex) 以 Java 程式語言中 double 的形式獲取此 ResultSet 物件的當前行中指定列的值。
double	getDouble(String columnLabel) 以 Java 程式語言中 double 的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getFetchDirection() 獲取此 ResultSet 物件的獲取方向。
int	getFetchSize() 獲取此 ResultSet 物件的獲取大小。
float	getFloat(int columnIndex) 以 Java 程式語言中 float 的形式獲取此 ResultSet 物件的當前行中指定列的值。
float	getFloat(String columnLabel) 以 Java 程式語言中 float 的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getHoldability() 獲取此 ResultSet 物件的可保存性
int	getInt(int columnIndex) 以 Java 程式語言中 int 的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getInt(String columnLabel) 以 Java 程式語言中 int 的形式獲取此 ResultSet 物件的當前行中指定列的值。
long	getLong(int columnIndex) 以 Java 程式語言中 long 的形式獲取此 ResultSet 物件的當前行中指定列的值。
long	getLong(String columnLabel) 以 Java 程式語言中 long 的形式獲取此 ResultSet 物件的當前行中指定列的值。
ResultSetMetaData	getMetaData() 獲取此 ResultSet 物件的列的編號、型別和屬性。
Reader	getNCharacterStream(int columnIndex) 以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Reader	getNCharacterStream(String columnLabel) 以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
NClob	getNClob(int columnIndex) 以 Java 程式語言中 NClob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
NClob	getNClob(String columnLabel) 以 Java 程式語言中 NClob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
String	getNString(int columnIndex) 以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。
String	getNString(String columnLabel) 以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Object	getObject(int columnIndex) 以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Object	getObject(int columnIndex, Map<String,Class<?>> map) 以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Object	getObject(String columnLabel) 以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Object	getObject(String columnLabel, Map<String,Class<?>> map) 以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Ref	getRef(int columnIndex) 以 Java 程式語言中 Ref 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Ref	getRef(String columnLabel) 以 Java 程式語言中 Ref 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getRow() 獲取當前行編號。
RowId	getRowId(int columnIndex) 以 Java 程式語言中 java.sql.RowId 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
RowId	getRowId(String columnLabel) 以 Java 程式語言中 java.sql.RowId 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
short	getShort(int columnIndex) 以 Java 程式語言中 short 的形式獲取此 ResultSet 物件的當前行中指定列的值。
short	getShort(String columnLabel) 以 Java 程式語言中 short 的形式獲取此 ResultSet 物件的當前行中指定列的值。
SQLXML	getSQLXML(int columnIndex) 以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
SQLXML	getSQLXML(String columnLabel) 以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Statement	getStatement() 獲取產生此 ResultSet 物件的 Statement 物件。
String	getString(int columnIndex) 以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。
String	getString(String columnLabel) 以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。
Time	getTime(int columnIndex) 以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Time	getTime(int columnIndex, Calendar cal) 以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Time	getTime(String columnLabel) 以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Time	getTime(String columnLabel, Calendar cal) 以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Timestamp	getTimestamp(int columnIndex) 以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Timestamp	getTimestamp(int columnIndex, Calendar cal) 以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Timestamp	getTimestamp(String columnLabel) 以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
Timestamp	getTimestamp(String columnLabel, Calendar cal) 以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
int	getType() 獲取此 ResultSet 物件的型別。
InputStream	getUnicodeStream(int columnIndex) 已過時。 使用 getCharacterStream 取代 getUnicodeStream
InputStream	getUnicodeStream(String columnLabel) 已過時。 使用 getCharacterStream 代替
URL	getURL(int columnIndex) 以 Java 程式語言中 java.net.URL 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
URL	getURL(String columnLabel) 以 Java 程式語言中 java.net.URL 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。
SQLWarning	getWarnings() 獲取此 ResultSet 物件上的調用報告的第一個警告。
void	insertRow() 將插入行的內容插入到此 ResultSet 物件和資料庫中。
boolean	isAfterLast() 獲取鼠標是否位於此 ResultSet 物件的最後一行之後。
boolean	isBeforeFirst() 獲取鼠標是否位於此 ResultSet 物件的第一行之前。
boolean	isClosed() 獲取此 ResultSet 物件是否已關閉。
boolean	isFirst() 獲取鼠標是否位於此 ResultSet 物件的第一行。
boolean	isLast() 獲取鼠標是否位於此 ResultSet 物件的最後一行。
boolean	last() 將鼠標移動到此 ResultSet 物件的最後一行。
void	moveToCurrentRow() 將鼠標移動到記住的鼠標位置，通常為當前行。
void	moveToInsertRow() 將鼠標移動到插入行。
boolean	next() 將鼠標從當前位置向前移一行。
boolean	previous() 將鼠標移動到此 ResultSet 物件的上一行。
void	refreshRow() 用資料庫中的最近值刷新當前行。
boolean	relative(int rows) 按相對行數（或正或負）移動鼠標。
boolean	rowDeleted() 獲取是否已刪除某行。
boolean	rowInserted() 獲取當前行是否已有插入。
boolean	rowUpdated() 獲取是否已更新當前行。
void	setFetchDirection(int direction) 設置此 ResultSet 物件中行的處理方向。
void	setFetchSize(int rows) 為 JDBC 驅動程序設置此 ResultSet 物件需要更多行時應該從資料庫獲取的行數。
void	updateArray(int columnIndex, Array x) 用 java.sql.Array 值更新指定列。
void	updateArray(String columnLabel, Array x) 用 java.sql.Array 值更新指定列。
void	updateAsciiStream(int columnIndex, InputStream x) 用 ascii 串流值更新指定的列。
void	updateAsciiStream(int columnIndex, InputStream x, int length) 用 ascii 串流值更新指定列，該列將具有指定位元組數。
void	updateAsciiStream(int columnIndex, InputStream x, long length) 用 ascii 串流值更新指定的列，該值將具有指定的位元組數。
void	updateAsciiStream(String columnLabel, InputStream x) 用 ascii 串流值更新指定列。
void	updateAsciiStream(String columnLabel, InputStream x, int length) 用 ascii 串流值更新指定列，該列具有指定的位元組數。
void	updateAsciiStream(String columnLabel, InputStream x, long length) 用 ascii 串流值更新指定的列，該值將具有指定的位元組數。
void	updateBigDecimal(int columnIndex, BigDecimal x) 用 java.math.BigDecimal 值更新指定列。
void	updateBigDecimal(String columnLabel, BigDecimal x) 用 java.sql.BigDecimal 值更新指定列。
void	updateBinaryStream(int columnIndex, InputStream x) 用二進制串流值更新指定的列。
void	updateBinaryStream(int columnIndex, InputStream x, int length) 用二進制串流值更新指定列，該列將具有指定位元組數。
void	updateBinaryStream(int columnIndex, InputStream x, long length) 用二進制串流值更新指定的列，該值將具有指定的位元組數。
void	updateBinaryStream(String columnLabel, InputStream x) 用二進制串流值更新指定列。
void	updateBinaryStream(String columnLabel, InputStream x, int length) 用二進制串流值更新指定列，該列具有指定的位元組數。
void	updateBinaryStream(String columnLabel, InputStream x, long length) 用二進制串流值更新指定的列，該值將具有指定的位元組數。
void	updateBlob(int columnIndex, Blob x) 用 java.sql.Blob 值更新指定列。
void	updateBlob(int columnIndex, InputStream inputStream) 使用給定輸入串流值更新指定列。
void	updateBlob(int columnIndex, InputStream inputStream, long length) 使用給定輸入串流更新指定的列，該串流將具有指定的位元組數。
void	updateBlob(String columnLabel, Blob x) 用 java.sql.Blob 值更新指定列。
void	updateBlob(String columnLabel, InputStream inputStream) 使用給定輸入串流值更新指定列。
void	updateBlob(String columnLabel, InputStream inputStream, long length) 使用給定輸入串流更新指定列，該串流將具有指定的位元組數。
void	updateBoolean(int columnIndex, boolean x) 用 boolean 值更新指定列。
void	updateBoolean(String columnLabel, boolean x) 用 boolean 值更新指定列。
void	updateByte(int columnIndex, byte x) 用 byte 值更新指定列。
void	updateByte(String columnLabel, byte x) 用 byte 值更新指定列。
void	updateBytes(int columnIndex, byte[] x) 用 byte 陣列值更新指定列。
void	updateBytes(String columnLabel, byte[] x) 用位元組陣列值更新指定列。
void	updateCharacterStream(int columnIndex, Reader x) 用字元串流值更新指定的列。
void	updateCharacterStream(int columnIndex, Reader x, int length) 用字元串流值更新指定列，該列將具有指定位元組數。
void	updateCharacterStream(int columnIndex, Reader x, long length) 用字元串流值更新指定的列，該值將具有指定的位元組數。
void	updateCharacterStream(String columnLabel, Reader reader) 用字元串流值更新指定列。
void	updateCharacterStream(String columnLabel, Reader reader, int length) 用字元串流值更新指定列，該列具有指定的位元組數。
void	updateCharacterStream(String columnLabel, Reader reader, long length) 用字元串流值更新指定的列，該值將具有指定的位元組數。
void	updateClob(int columnIndex, Clob x) 用 java.sql.Clob 值更新指定列。
void	updateClob(int columnIndex, Reader reader) 使用給定的 Reader 物件更新指定列。
void	updateClob(int columnIndex, Reader reader, long length) 使用給定的 Reader 物件更新指定列，該物件是給定的字元長度數目。
void	updateClob(String columnLabel, Clob x) 用 java.sql.Clob 值更新指定列。
void	updateClob(String columnLabel, Reader reader) 使用給定的 Reader 物件更新指定列。
void	updateClob(String columnLabel, Reader reader, long length) 使用給定的 Reader 物件更新指定列，該物件是給定的字元長度數目。
void	updateDate(int columnIndex, Date x) 用 java.sql.Date 值更新指定列。
void	updateDate(String columnLabel, Date x) 用 java.sql.Date 值更新指定列。
void	updateDouble(int columnIndex, double x) 用 double 值更新指定列。
void	updateDouble(String columnLabel, double x) 用 double 值更新指定列。
void	updateFloat(int columnIndex, float x) 用 float 值更新指定列。
void	updateFloat(String columnLabel, float x) 用 float 值更新指定列。
void	updateInt(int columnIndex, int x) 用 int 值更新指定列。
void	updateInt(String columnLabel, int x) 用 int 值更新指定列。
void	updateLong(int columnIndex, long x) 用 long 值更新指定列。
void	updateLong(String columnLabel, long x) 用 long 值更新指定列。
void	updateNCharacterStream(int columnIndex, Reader x) 用字元串流值更新指定的列。
void	updateNCharacterStream(int columnIndex, Reader x, long length) 用字元串流值更新指定的列，該值將具有指定的位元組數。
void	updateNCharacterStream(String columnLabel, Reader reader) 用字元串流值更新指定的列。
void	updateNCharacterStream(String columnLabel, Reader reader, long length) 用字元串流值更新指定的列，該值將具有指定的位元組數。
void	updateNClob(int columnIndex, NClob nClob) 用 java.sql.NClob 值更新指定的列。
void	updateNClob(int columnIndex, Reader reader) 使用給定的 Reader 物件更新指定列。
void	updateNClob(int columnIndex, Reader reader, long length) 使用給定的 Reader 物件更新指定的列，該物件是給定的字元長度數目。
void	updateNClob(String columnLabel, NClob nClob) 用 java.sql.NClob 值更新指定的列。
void	updateNClob(String columnLabel, Reader reader) 使用給定的 Reader 物件更新指定列。
void	updateNClob(String columnLabel, Reader reader, long length) 使用給定的 Reader 物件更新指定的列，該物件是給定的字元長度數目。
void	updateNString(int columnIndex, String nString) 用 String 值更新指定的列。
void	updateNString(String columnLabel, String nString) 用 String 值更新指定的列。
void	updateNull(int columnIndex) 用 null 值更新指定列。
void	updateNull(String columnLabel) 用 null 值更新指定列。
void	updateObject(int columnIndex, Object x) 用 Object 值更新指定列。
void	updateObject(int columnIndex, Object x, int scaleOrLength) 用 Object 值更新指定列。
void	updateObject(String columnLabel, Object x) 用 Object 值更新指定列。
void	updateObject(String columnLabel, Object x, int scaleOrLength) 用 Object 值更新指定列。
void	updateRef(int columnIndex, Ref x) 用 java.sql.Ref 值更新指定列。
void	updateRef(String columnLabel, Ref x) 用 java.sql.Ref 值更新指定列。
void	updateRow() 用此 ResultSet 物件的當前行的新內容更新底層資料庫。
void	updateRowId(int columnIndex, RowId x) 用 RowId 值更新指定列。
void	updateRowId(String columnLabel, RowId x) 用 RowId 值更新指定的列。
void	updateShort(int columnIndex, short x) 用 short 值更新指定列。
void	updateShort(String columnLabel, short x) 用 short 值更新指定列。
void	updateSQLXML(int columnIndex, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定列。
void	updateSQLXML(String columnLabel, SQLXML xmlObject) 用 java.sql.SQLXML 值更新指定的列。
void	updateString(int columnIndex, String x) 用 String 值更新指定列。
void	updateString(String columnLabel, String x) 用 String 值更新指定列。
void	updateTime(int columnIndex, Time x) 用 java.sql.Time 值更新指定列。
void	updateTime(String columnLabel, Time x) 用 java.sql.Time 值更新指定列。
void	updateTimestamp(int columnIndex, Timestamp x) 用 java.sql.Timestamp 值更新指定列。
void	updateTimestamp(String columnLabel, Timestamp x) 用 java.sql.Timestamp 值更新指定列。
boolean	wasNull() 報告最後一個讀取的列是否具有值 SQL NULL。

從介面 java.sql.Wrapper 繼承的方法

isWrapperFor, unwrap

欄位詳細資訊

FETCH_FORWARD

static final int FETCH_FORWARD

該常數指示將按正向（即從第一個到最後一個）處理結果集中的行。setFetchDirection 方法將此常數用作驅動程序的提示，驅動程序可能忽略它。

從以下版本開始：

1.2

另請參見：

常數欄位值

FETCH_REVERSE

static final int FETCH_REVERSE

該常數指示將按逆向（即從最後一個到第一個）處理結果集中的行處理。setFetchDirection 方法將此常數用作驅動程序的提示，驅動程序可能忽略它。

從以下版本開始：

1.2

另請參見：

常數欄位值

FETCH_UNKNOWN

static final int FETCH_UNKNOWN

該常數指示結果集中的行的處理順序未知。setFetchDirection 方法將此常數用作驅動程序的提示，驅動程序可能忽略它。

另請參見：

常數欄位值

TYPE_FORWARD_ONLY

static final int TYPE_FORWARD_ONLY

該常數指示鼠標只能向前移動的 ResultSet 物件的型別。

從以下版本開始：

1.2

另請參見：

常數欄位值

TYPE_SCROLL_INSENSITIVE

static final int TYPE_SCROLL_INSENSITIVE

該常數指示可滾動但通常不受 ResultSet 底層資料更改影響的 ResultSet 物件的型別。

從以下版本開始：

1.2

另請參見：

常數欄位值

TYPE_SCROLL_SENSITIVE

static final int TYPE_SCROLL_SENSITIVE

該常數指示可滾動並且通常受 ResultSet 底層資料更改影響的 ResultSet 物件的型別。

從以下版本開始：

1.2

另請參見：

常數欄位值

CONCUR_READ_ONLY

static final int CONCUR_READ_ONLY

該常數指示不可以更新的 ResultSet 物件的共時網要。

從以下版本開始：

1.2

另請參見：

常數欄位值

CONCUR_UPDATABLE

static final int CONCUR_UPDATABLE

該常數指示可以更新的 ResultSet 物件的共時網要。

從以下版本開始：

1.2

另請參見：

常數欄位值

HOLD_CURSORS_OVER_COMMIT

static final int HOLD_CURSORS_OVER_COMMIT

該常數指示提交當前事務時，具有此可保存性的打開的 ResultSet 物件將保持開放。

從以下版本開始：

1.4

另請參見：

常數欄位值

CLOSE_CURSORS_AT_COMMIT

static final int CLOSE_CURSORS_AT_COMMIT

該常數指示提交當前事務時，具有此可保存性的打開的 ResultSet 物件將被關閉。

從以下版本開始：

1.4

另請參見：

常數欄位值

方法詳細資訊

next

boolean next()
             throws SQLException

將鼠標從當前位置向前移一行。ResultSet 鼠標最初位於第一行之前；第一次調用 next 方法使第一行成為當前行；第二次調用使第二行成為當前行，依此類別推。

當調用 next 方法返回 false 時，鼠標位於最後一行的後面。任何要求當前行的 ResultSet 方法調用將導致拋出 SQLException。如果結果集的型別是 TYPE_FORWARD_ONLY，則其 JDBC 驅動程序實作對後續 next 調用是返回 false 還是拋出 SQLException 將由供應商指定。

如果對當前行開啟了輸入串流，則調用 next 方法將隱式關閉它。讀取新行時，將清除 ResultSet 物件的警告鏈。

返回：

如果新的當前行有效，則返回 true；如果不存在下一行，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在關閉的結果集上調用此方法

close

void close()
           throws SQLException

立即釋放此 ResultSet 物件的資料庫和 JDBC 資源，而不是等待該物件自動關閉時發生此操作。

關閉 ResultSet 物件不會關閉 ResultSet 創建的 Blob、Clob 或 NClob 物件。Blob、Clob 或 NClob 物件至少在創建它們的事務期間持續有效，除非調用了其 free 方法。

當關閉 ResultSet 時，所有通過調用 getMetaData 方法創建的 ResultSetMetaData 實例都可以存取。

註：當產生 ResultSet 物件的 Statement 物件關閉、重新執行或用來從多個結果的序列獲取下一個結果時，該 Statement 物件將自動關閉 ResultSet 物件。

在已關閉的 ResultSet 物件上調用 close 方法是無操作 (no-op)。

拋出：

SQLException - 如果發生資料庫存取錯誤

wasNull

boolean wasNull()
                throws SQLException

報告最後一個讀取的列是否具有值 SQL NULL。注意，必須首先對列調用一個獲取方法嘗試讀取其值，然後調用 wasNull 方法查看讀取的值是否為 SQL NULL。

返回：

如果最後一個讀取的列值為 SQL NULL，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getString

String getString(int columnIndex)
                 throws SQLException

以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getBoolean

boolean getBoolean(int columnIndex)
                   throws SQLException

以 Java 程式語言中 boolean 的形式獲取此 ResultSet 物件的當前行中指定列的值。

如果指定列的資料型別為 CHAR 或 VARCHAR 且包含 "0"，或者資料型別為 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0，則返回 false 值。如果指定列的資料型別為 CHAR 或 VARCHAR 且包含 "1"，或者資料型別為 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1，則返回 true 值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 false

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getByte

byte getByte(int columnIndex)
             throws SQLException

以 Java 程式語言中 byte 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getShort

short getShort(int columnIndex)
               throws SQLException

以 Java 程式語言中 short 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getInt

int getInt(int columnIndex)
           throws SQLException

以 Java 程式語言中 int 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getLong

long getLong(int columnIndex)
             throws SQLException

以 Java 程式語言中 long 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getFloat

float getFloat(int columnIndex)
               throws SQLException

以 Java 程式語言中 float 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getDouble

double getDouble(int columnIndex)
                 throws SQLException

以 Java 程式語言中 double 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getBigDecimal

BigDecimal getBigDecimal(int columnIndex,
                         int scale)
                         throws SQLException

已過時。

以 Java 程式語言中 java.sql.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

scale - 小數點右邊的位數

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

getBytes

byte[] getBytes(int columnIndex)
                throws SQLException

以 Java 程式語言中 byte 陣列的形式獲取此 ResultSet 物件的當前行中指定列的值。這些位元組表示驅動程序返回的原始值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getDate

Date getDate(int columnIndex)
             throws SQLException

以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getTime

Time getTime(int columnIndex)
             throws SQLException

以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getTimestamp

Timestamp getTimestamp(int columnIndex)
                       throws SQLException

以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getAsciiStream

InputStream getAsciiStream(int columnIndex)
                           throws SQLException

以 ASCII 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。然後，可以按塊從串流中讀取值。此方法尤其適合於獲取很大的 LONGVARCHAR 值。JDBC 驅動程序將執行從資料庫格式到 ASCII 的任何必要轉換。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 InputStream.available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

以一位元組 ASCII 字元串流的形式返回傳遞資料庫列值的 Java 輸入串流；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getUnicodeStream

InputStream getUnicodeStream(int columnIndex)
                             throws SQLException

已過時。 使用 getCharacterStream 取代 getUnicodeStream

以兩位元組 3 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。第一個位元組是高位元組；第二個位元組是低位元組。然後，可以按塊從串流中讀取值。此方法尤其適合於獲取很大的 LONGVARCHAR 值。JDBC 驅動程序將執行從資料庫格式到 Unicode 的任何必要轉換。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 InputStream.available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

以兩位元組 Unicode 字元串流的形式返回傳遞資料庫列值的 Java 輸入串流；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

getBinaryStream

InputStream getBinaryStream(int columnIndex)
                            throws SQLException

以未解釋位元組的串流的形式獲取此 ResultSet 物件的當前行中指定列的值。然後，可以按塊從串流中讀取值。此方法尤其適合於獲取很大的 LONGVARBINARY 值。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 InputStream.available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

以未解釋位元組的串流的形式返回傳遞資料庫列值的 Java 輸入串流；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getString

String getString(String columnLabel)
                 throws SQLException

以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getBoolean

boolean getBoolean(String columnLabel)
                   throws SQLException

以 Java 程式語言中 boolean 的形式獲取此 ResultSet 物件的當前行中指定列的值。

如果指定列的資料型別為 CHAR 或 VARCHAR 且包含 "0"，或者資料型別為 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 0，則返回 false 值。如果指定列的資料型別為 CHAR 或 VARCHAR 且包含 "1"，或者資料型別為 BIT、TINYINT、SMALLINT、INTEGER 或 BIGINT 且包含 1，則返回 true 值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 false

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getByte

byte getByte(String columnLabel)
             throws SQLException

以 Java 程式語言中 byte 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getShort

short getShort(String columnLabel)
               throws SQLException

以 Java 程式語言中 short 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getInt

int getInt(String columnLabel)
           throws SQLException

以 Java 程式語言中 int 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getLong

long getLong(String columnLabel)
             throws SQLException

以 Java 程式語言中 long 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getFloat

float getFloat(String columnLabel)
               throws SQLException

以 Java 程式語言中 float 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getDouble

double getDouble(String columnLabel)
                 throws SQLException

以 Java 程式語言中 double 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 0

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getBigDecimal

BigDecimal getBigDecimal(String columnLabel,
                         int scale)
                         throws SQLException

已過時。

以 Java 程式語言中 java.math.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

scale - 小數點右邊的位數

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

getBytes

byte[] getBytes(String columnLabel)
                throws SQLException

以 Java 程式語言中 byte 陣列的形式獲取此 ResultSet 物件的當前行中指定列的值。這些位元組表示驅動程序返回的原始值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getDate

Date getDate(String columnLabel)
             throws SQLException

以 Java 程式語言中的 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getTime

Time getTime(String columnLabel)
             throws SQLException

以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getTimestamp

Timestamp getTimestamp(String columnLabel)
                       throws SQLException

以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getAsciiStream

InputStream getAsciiStream(String columnLabel)
                           throws SQLException

以 ASCII 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。然後，可以按塊從串流中讀取值。此方法尤其適合於獲取很大的 LONGVARCHAR 值。JDBC 驅動程序將執行從資料庫格式到 ASCII 的任何必要轉換。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

以一位元組 ASCII 字元串流的形式返回傳遞資料庫列值的 Java 輸入串流。如果值為 SQL NULL，則返回值為 null。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getUnicodeStream

InputStream getUnicodeStream(String columnLabel)
                             throws SQLException

已過時。 使用 getCharacterStream 代替

以兩位元組 Unicode 字元串流的形式獲取此 ResultSet 物件的當前行中指定列的值。第一個位元組是高位元組；第二個位元組是低位元組。然後，可以按塊從串流中讀取值。此方法尤其適合於獲取很大的 LONGVARCHAR 值。採用 JDBC 技術的驅動程序將執行從資料庫格式到 Unicode 的任何必要轉換。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 InputStream.available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

以兩位元組 Unicode 字元串流的形式返回傳遞資料庫列值的 Java 輸入串流。如果值為 SQL NULL，則返回值為 null。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

getBinaryStream

InputStream getBinaryStream(String columnLabel)
                            throws SQLException

以未解釋的 byte 串流的形式獲取此 ResultSet 物件的當前行中指定列的值。然後，可以按塊從串流中讀取該值。此方法尤其適合於獲取很大的 LONGVARBINARY 值。

註：在獲取任何其他列的值之前必須讀取返回串流中的所有資料。下一次調用獲取方法將隱式關閉該串流。此外，當調用 available 方法時，不管是否存在可用資料，串流都可能返回 0。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

以未解釋位元組串流的形式返回傳遞資料庫列值的 Java 輸入串流；如果值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getWarnings

SQLWarning getWarnings()
                       throws SQLException

獲取此 ResultSet 物件上的調用報告的第一個警告。此 ResultSet 物件上的後續警告會被連接到此方法返回的 SQLWarning 物件。

每次讀取新行時，都會自動清除警告鏈。不可以在已經關閉的 ResultSet 物件上調用此方法；這樣做將導致拋出 SQLException。

註：此警告鏈僅包含 ResultSet 方法產生的警告。Statement 方法（如讀取 OUT 參數）產生的任何警告都將連接在 Statement 物件上。

返回：

報告的第一個 SQLWarning 物件；如果不存在，則返回 null

拋出：

SQLException - 如果發生資料庫存取錯誤或在關閉的結果集上調用此方法

clearWarnings

void clearWarnings()
                   throws SQLException

清除在此 ResultSet 物件上報告的所有警告。調用此方法後，在為此 ResultSet 物件報告新的警告之前，getWarnings 方法將返回 null。

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getCursorName

String getCursorName()
                     throws SQLException

獲取此 ResultSet 物件使用的 SQL 鼠標的名稱。

在 SQL 中，通過指定的鼠標獲取結果表。通過一個參考鼠標名稱來定位的更新/刪除語句，可以更新或刪除結果集的當前行。為了確保鼠標具有支持更新的適當隔離級別，鼠標的 SELECT 語句的形式應該為 SELECT FOR UPDATE。如果省略 FOR UPDATE，則定位更新可能失敗。

JDBC API 通過提供 ResultSet 物件使用的 SQL 鼠標的名稱支持此 SQL 功能。ResultSet 物件的當前行也是此 SQL 鼠標的當前行。

返回：

此 ResultSet 物件的鼠標的 SQL 名稱

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

getMetaData

ResultSetMetaData getMetaData()
                              throws SQLException

獲取此 ResultSet 物件的列的編號、型別和屬性。

返回：

此 ResultSet 物件的列的描述

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getObject

Object getObject(int columnIndex)
                 throws SQLException

以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。

此方法將以 Java 物件的形式返回給定列的值。Java 物件的型別將為與該列的 SQL 型別相對應的預設 Java 物件型別，它遵守在 JDBC 規範中指定的內置型別的映射關係。如果值為 SQL NULL，則驅動程序返回一個 Java null。

此方法還可用於讀取特定於資料庫的抽象資料型別。在 JDBC 2.0 API 中，可以擴展 getObject 方法的行為來實作 SQL 自定義型別的資料。

如果 Connection.getTypeMap 不拋出 SQLFeatureNotSupportedException，則當列包含結構值或獨特值時，此方法的行為類似於調用：getObject(columnIndex, this.getStatement().getConnection().getTypeMap())。 如果 Connection.getTypeMap 拋出 SQLFeatureNotSupportedException，則結構值不受支持，獨特值映射到 DISTINCT 型別的底層 SQL 型別確定的預設 Java 類別。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

保存列值的 java.lang.Object

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getObject

Object getObject(String columnLabel)
                 throws SQLException

以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。

此方法將以 Java 物件的形式返回給定列的值。Java 物件的型別將為與該列的 SQL 型別相對應的預設 Java 物件型別，它遵守在 JDBC 規範中指定的內置型別的映射關係。如果值為 SQL NULL，則驅動程序返回一個 Java null。

此方法還可用於讀取特定於資料庫的抽象資料型別。

在 JDBC 2.0 API 中，可以擴展 getObject 方法的行為來實作 SQL 自定義型別的資料。當列包含結構化的或獨特的值時，此方法的行為類似於調用：getObject(columnIndex, this.getStatement().getConnection().getTypeMap())。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

保存列值的 java.lang.Object

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

findColumn

int findColumn(String columnLabel)
               throws SQLException

將給定的 ResultSet 列標籤映射到其 ResultSet 列索引。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

給定列名稱的列索引

拋出：

SQLException - 如果 ResultSet 物件不包含標記為 columnLabel 的列，發生資料庫存取錯誤或在已關閉的結果集上調用此方法

getCharacterStream

Reader getCharacterStream(int columnIndex)
                          throws SQLException

以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

包含列值的 java.io.Reader 物件；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getCharacterStream

Reader getCharacterStream(String columnLabel)
                          throws SQLException

以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

包含列值的 java.io.Reader 物件；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getBigDecimal

BigDecimal getBigDecimal(int columnIndex)
                         throws SQLException

以具有全精度的 java.math.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值（全精度）；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getBigDecimal

BigDecimal getBigDecimal(String columnLabel)
                         throws SQLException

以具有全精度的 java.math.BigDecimal 的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值（全精度）；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

isBeforeFirst

boolean isBeforeFirst()
                      throws SQLException

獲取鼠標是否位於此 ResultSet 物件的第一行之前。

註：對於帶有 TYPE_FORWARD_ONLY 的結果集型別的 ResultSet，對 isBeforeFirst 方法的支持是可選的

返回：

如果鼠標位於第一行之前，則返回 true；如果鼠標位於任何其他位置或者結果集不包含任何行，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

isAfterLast

boolean isAfterLast()
                    throws SQLException

獲取鼠標是否位於此 ResultSet 物件的最後一行之後。

註：對於帶有 TYPE_FORWARD_ONLY 的結果集型別的 ResultSet，對 isAfterLast 方法的支持是可選的

返回：

如果鼠標位於最後一行之後，則返回 true；如果鼠標位於任何其他位置或者結果集不包含任何行，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

isFirst

boolean isFirst()
                throws SQLException

獲取鼠標是否位於此 ResultSet 物件的第一行。

註：對於帶有 TYPE_FORWARD_ONLY 的結果集型別的 ResultSet，對 isFirst 方法的支持是可選的

返回：

如果鼠標位於第一行，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

isLast

boolean isLast()
               throws SQLException

獲取鼠標是否位於此 ResultSet 物件的最後一行。註：調用 isLast 方法可能開銷很大，因為 JDBC 驅動程序可能需要再往後獲取一行，以確定當前行是否為結果集中的最後一行。

註：對於帶有 TYPE_FORWARD_ONLY 的結果集型別的 ResultSet，對 isLast 方法的支持是可選的

返回：

如果鼠標位於最後一行上，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

beforeFirst

void beforeFirst()
                 throws SQLException

將鼠標移動到此 ResultSet 物件的開頭，正好位於第一行之前。如果結果集中不包含任何行，則此方法無效。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

afterLast

void afterLast()
               throws SQLException

將鼠標移動到此 ResultSet 物件的末尾，正好位於最後一行之後。如果結果集中不包含任何行，則此方法無效。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

first

boolean first()
              throws SQLException

將鼠標移動到此 ResultSet 物件的第一行。

返回：

如果鼠標位於有效行，則返回 true；如果結果集中不存在任何行，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

last

boolean last()
             throws SQLException

將鼠標移動到此 ResultSet 物件的最後一行。

返回：

如果鼠標位於有效行，則返回 true；如果結果集中不存在任何行，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getRow

int getRow()
           throws SQLException

獲取當前行編號。第一行為 1 號，第二行為 2 號，依此類別推。

註：對於帶有 TYPE_FORWARD_ONLY 的結果集型別的 ResultSet，對 getRow 方法的支持是可選的

返回：

當前行的編號；如果不存在當前行，則返回 0

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

absolute

boolean absolute(int row)
                 throws SQLException

將鼠標移動到此 ResultSet 物件的給定行編號。

如果行編號為正，則將鼠標移動到相對於結果集開頭的給定行編號。第一行為行 1，第二行為行 2，依此類別推。

如果給定行編號為負，則將鼠標移動到相對於結果集末尾的絕對行位置。例如，調用方法 absolute(-1) 將鼠標置於最後一行；調用方法 absolute(-2) 將鼠標移動到倒數第二行，依此類別推。

試圖將鼠標置於結果集的第一行/最後一行之外將導致鼠標位於第一行之前或最後一行之後。

註：調用 absolute(1) 等效於調用 first()。調用 absolute(-1) 等效於調用 last()。

參數：

row - 鼠標應該移動到的行的編號。正的編號指示從結果集開頭開始計數的行編號；負的編號指示從結果集末尾開始計數的行編號

返回：

如果鼠標移動到此 ResultSet 物件的位置處，則返回 true；如果鼠標在第一行的前面或最後一行的後面，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

relative

boolean relative(int rows)
                 throws SQLException

按相對行數（或正或負）移動鼠標。試圖移動到結果集的第一行/最後一行之外，會將鼠標置於第一行之前或最後一行之後。調用 relative(0) 有效，但是不更改鼠標位置。

註：調用方法 relative(1) 等效於調用方法 next()，而調用方法 relative(-1) 等效於調用方法 previous()。

參數：

rows - 指定從當前行開始移動的行數的 int；正數表示鼠標向前移動；負數表示鼠標向後移動

返回：

如果鼠標位於行上，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

previous

boolean previous()
                 throws SQLException

將鼠標移動到此 ResultSet 物件的上一行。

當調用 previous 方法返回 false 時，鼠標位於第一行之前。要求當前行的任何 ResultSet 方法的調用將導致拋出 SQLException。

如果開啟了對當前行的輸入串流，則調用 previous 方法將隱式關閉它。讀取新的一行時清除 ResultSet 物件的警告更改。

返回：

如果鼠標現在位於有效行上，則返回 true；如果鼠標位於第一行的前面，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

setFetchDirection

void setFetchDirection(int direction)
                       throws SQLException

設置此 ResultSet 物件中行的處理方向。初始值由產生此 ResultSet 物件的 Statement 物件確定。獲取方向可以在任何時間更改。

參數：

direction - 指定建議獲取方向的 int；ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE 或 ResultSet.FETCH_UNKNOWN 之一

拋出：

SQLException - 如果發生資料庫存取錯誤，在已關閉的結果集上調用此方法或結果集型別為 TYPE_FORWARD_ONLY 但獲取方向不是 FETCH_FORWARD

從以下版本開始：

1.2

另請參見：

Statement.setFetchDirection(int), getFetchDirection()

getFetchDirection

int getFetchDirection()
                      throws SQLException

獲取此 ResultSet 物件的獲取方向。

返回：

此 ResultSet 物件的當前獲取方向

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

另請參見：

setFetchDirection(int)

setFetchSize

void setFetchSize(int rows)
                  throws SQLException

為 JDBC 驅動程序設置此 ResultSet 物件需要更多行時應該從資料庫獲取的行數。如果指定的獲取大小為零，則 JDBC 驅動程序忽略該值，隨意對獲取大小作出它自己的最佳猜測。預設值由創建結果集的 Statement 物件設置。獲取大小可以在任何時間更改。

參數：

rows - 要獲取的行數

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或不滿足條件 rows >= 0

從以下版本開始：

1.2

另請參見：

getFetchSize()

getFetchSize

int getFetchSize()
                 throws SQLException

獲取此 ResultSet 物件的獲取大小。

返回：

此 ResultSet 物件的當前獲取大小

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

另請參見：

setFetchSize(int)

getType

int getType()
            throws SQLException

獲取此 ResultSet 物件的型別。型別由創建結果集的 Statement 物件確定。

返回：

ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE 或 ResultSet.TYPE_SCROLL_SENSITIVE

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getConcurrency

int getConcurrency()
                   throws SQLException

獲取此 ResultSet 物件的共時網要。使用的共時由創建結果集的 Statement 物件確定。

返回：

共時型別，ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

rowUpdated

boolean rowUpdated()
                   throws SQLException

獲取是否已更新當前行。返回值取決於結果集是否可以檢測到更新。

註：對於 CONCUR_READ_ONLY 的結果集共時性，對 rowUpdated 方法的支持是可選的

返回：

如果所有者和其他人檢測到當前行已進行可見更新，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

另請參見：

DatabaseMetaData.updatesAreDetected(int)

rowInserted

boolean rowInserted()
                    throws SQLException

獲取當前行是否已有插入。返回值取決於此 ResultSet 物件是否可以檢測到可見插入。

註：對於 CONCUR_READ_ONLY 的結果集共時性，對 rowUpdated 方法的支持是可選的

返回：

如果當前檢測到已插入，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

另請參見：

DatabaseMetaData.insertsAreDetected(int)

rowDeleted

boolean rowDeleted()
                   throws SQLException

獲取是否已刪除某行。刪除的行可能在結果集中留下一個可見的“洞”。此方法可用於檢測結果集中的洞。返回值取決於此 ResultSet 物件是否可以檢測到刪除。

註：對於 CONCUR_READ_ONLY 的結果集共時性，對 rowDeleted 方法的支持是可選的

返回：

如果所有者或其他人檢測到當前行已刪除，則返回 true；否則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

另請參見：

DatabaseMetaData.deletesAreDetected(int)

updateNull

void updateNull(int columnIndex)
                throws SQLException

用 null 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBoolean

void updateBoolean(int columnIndex,
                   boolean x)
                   throws SQLException

用 boolean 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateByte

void updateByte(int columnIndex,
                byte x)
                throws SQLException

用 byte 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateShort

void updateShort(int columnIndex,
                 short x)
                 throws SQLException

用 short 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateInt

void updateInt(int columnIndex,
               int x)
               throws SQLException

用 int 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateLong

void updateLong(int columnIndex,
                long x)
                throws SQLException

用 long 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateFloat

void updateFloat(int columnIndex,
                 float x)
                 throws SQLException

用 float 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateDouble

void updateDouble(int columnIndex,
                  double x)
                  throws SQLException

用 double 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBigDecimal

void updateBigDecimal(int columnIndex,
                      BigDecimal x)
                      throws SQLException

用 java.math.BigDecimal 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateString

void updateString(int columnIndex,
                  String x)
                  throws SQLException

用 String 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBytes

void updateBytes(int columnIndex,
                 byte[] x)
                 throws SQLException

用 byte 陣列值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateDate

void updateDate(int columnIndex,
                Date x)
                throws SQLException

用 java.sql.Date 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateTime

void updateTime(int columnIndex,
                Time x)
                throws SQLException

用 java.sql.Time 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateTimestamp

void updateTimestamp(int columnIndex,
                     Timestamp x)
                     throws SQLException

用 java.sql.Timestamp 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateAsciiStream

void updateAsciiStream(int columnIndex,
                       InputStream x,
                       int length)
                       throws SQLException

用 ascii 串流值更新指定列，該列將具有指定位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流的長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBinaryStream

void updateBinaryStream(int columnIndex,
                        InputStream x,
                        int length)
                        throws SQLException

用二進制串流值更新指定列，該列將具有指定位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流的長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateCharacterStream

void updateCharacterStream(int columnIndex,
                           Reader x,
                           int length)
                           throws SQLException

用字元串流值更新指定列，該列將具有指定位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流的長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateObject

void updateObject(int columnIndex,
                  Object x,
                  int scaleOrLength)
                  throws SQLException

用 Object 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

如果第二個參數是 InputStream，則該串流必須包含 scaleOrLength 指定的位元組數。如果第二個參數是 Reader，則它必須包含 scaleOrLength 指定的字元數。如果這些條件不為真，則執行該語句時驅動程序將產生一個 SQLException。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

scaleOrLength - 對於 java.math.BigDecimal 物件，此參數是小數點後的位數。對於 Java 物件型別 InputStream 和 Reader，此參數是該串流或 reader 中資料的長度。對於其他全部類別型，將忽略此值。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateObject

void updateObject(int columnIndex,
                  Object x)
                  throws SQLException

用 Object 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateNull

void updateNull(String columnLabel)
                throws SQLException

用 null 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBoolean

void updateBoolean(String columnLabel,
                   boolean x)
                   throws SQLException

用 boolean 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateByte

void updateByte(String columnLabel,
                byte x)
                throws SQLException

用 byte 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateShort

void updateShort(String columnLabel,
                 short x)
                 throws SQLException

用 short 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateInt

void updateInt(String columnLabel,
               int x)
               throws SQLException

用 int 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateLong

void updateLong(String columnLabel,
                long x)
                throws SQLException

用 long 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateFloat

void updateFloat(String columnLabel,
                 float x)
                 throws SQLException

用 float 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateDouble

void updateDouble(String columnLabel,
                  double x)
                  throws SQLException

用 double 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBigDecimal

void updateBigDecimal(String columnLabel,
                      BigDecimal x)
                      throws SQLException

用 java.sql.BigDecimal 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateString

void updateString(String columnLabel,
                  String x)
                  throws SQLException

用 String 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBytes

void updateBytes(String columnLabel,
                 byte[] x)
                 throws SQLException

用位元組陣列值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateDate

void updateDate(String columnLabel,
                Date x)
                throws SQLException

用 java.sql.Date 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateTime

void updateTime(String columnLabel,
                Time x)
                throws SQLException

用 java.sql.Time 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateTimestamp

void updateTimestamp(String columnLabel,
                     Timestamp x)
                     throws SQLException

用 java.sql.Timestamp 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateAsciiStream

void updateAsciiStream(String columnLabel,
                       InputStream x,
                       int length)
                       throws SQLException

用 ascii 串流值更新指定列，該列具有指定的位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

length - 串流的長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateBinaryStream

void updateBinaryStream(String columnLabel,
                        InputStream x,
                        int length)
                        throws SQLException

用二進制串流值更新指定列，該列具有指定的位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

length - 串流的長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateCharacterStream

void updateCharacterStream(String columnLabel,
                           Reader reader,
                           int length)
                           throws SQLException

用字元串流值更新指定列，該列具有指定的位元組數。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含新列值的 java.io.Reader 物件

length - 串流的長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateObject

void updateObject(String columnLabel,
                  Object x,
                  int scaleOrLength)
                  throws SQLException

用 Object 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

如果第二個參數是 InputStream，則該串流必須包含 scaleOrLength 指定的位元組數。如果第二個參數是 Reader，則它必須包含 scaleOrLength 指定的字元數。如果這些條件不為真，則執行該語句時驅動程序將產生一個 SQLException。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

scaleOrLength - 對於 java.math.BigDecimal 物件，此參數是小數點後的位數。對於 Java 物件型別 InputStream 和 Reader，此參數是該串流或 reader 中資料的長度。 對於其他全部類別型，將忽略此值。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateObject

void updateObject(String columnLabel,
                  Object x)
                  throws SQLException

用 Object 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

insertRow

void insertRow()
               throws SQLException

將插入行的內容插入到此 ResultSet 物件和資料庫中。調用此方法時，鼠標必須位於插入行上。

拋出：

SQLException - 如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法；如果在鼠標不位於插入行上時調用此方法，或者插入行中所有不可為 null 的列中還存在未分派非 null 值的列

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

updateRow

void updateRow()
               throws SQLException

用此 ResultSet 物件的當前行的新內容更新底層資料庫。鼠標不位於插入行上時不能調用此方法。

拋出：

SQLException - 如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY；在已關閉的結果集上調用此方法，或者在鼠標不位於插入行上時調用了此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

deleteRow

void deleteRow()
               throws SQLException

從此 ResultSet 物件和底層資料庫中刪除當前行。鼠標不位於插入行上時不能調用此方法。

拋出：

SQLException - 如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY；在已關閉的結果集上調用此方法，或者在鼠標不位於插入行上時調用了此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

refreshRow

void refreshRow()
                throws SQLException

用資料庫中的最近值刷新當前行。鼠標不位於插入行上時不能調用此方法。

refreshRow 方法提供一種讓應用程序顯式告知 JDBC 驅動程序從資料庫重新獲取行的方式。應用程序可能需要在 JDBC 驅動程序完成快取記憶體或預獲取操作後調用 refreshRow，以便從資料庫獲取行的最新值。如果獲取大小大於 1，則 JDBC 驅動程序可以一次實際刷新多行。

應根據事務隔離級別和鼠標敏感度確定是否重新獲取所有值。如果在調用更新方法之後，但在調用 updateRow 方法之前調用 refreshRow，則會丟失對行所作的更新。頻繁調用方法 refreshRow 可能導致性能下降。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法；結果集型別為 TYPE_FORWARD_ONLY，或者在鼠標不位於插入行上時調用了此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法，或者對於指定的結果集型別和結果集共時性此方法不受支持。

從以下版本開始：

1.2

cancelRowUpdates

void cancelRowUpdates()
                      throws SQLException

取消對 ResultSet 物件中的當前行所作的更新。此方法在調用更新方法之後，但在調用 updateRow 方法之前調用才可以回滾對行所作的更新。如果沒有進行任何更新或者已經調用 updateRow 方法，則此方法無效。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法；結果集共時性為 CONCUR_READ_ONLY，或者在鼠標不位於插入行上時調用了此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

moveToInsertRow

void moveToInsertRow()
                     throws SQLException

將鼠標移動到插入行。將鼠標置於插入行上時，當前的鼠標位置會被記住。插入行是一個與可更新結果集相關聯的特殊行。它實際上是一個緩衝區，在將行插入到結果集前可以通過調用更新方法在其中建構新行。當鼠標位於插入行上時，僅能調用更新方法、獲取方法以及 insertRow 方法。每次在調用 insertRow 之前調用此方法時，必須為結果集中的所有列分派值。在對列值調用獲取方法之前，必須調用更新方法。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

moveToCurrentRow

void moveToCurrentRow()
                      throws SQLException

將鼠標移動到記住的鼠標位置，通常為當前行。如果鼠標不位於插入行上，則此方法無效。

拋出：

SQLException - 如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getStatement

Statement getStatement()
                       throws SQLException

獲取產生此 ResultSet 物件的 Statement 物件。如果結果集是以其他方式產生的（如通過 DatabaseMetaData 方法），則此方法可能返回 null。

返回：

產生此 ResultSet 物件的 Statment 物件；如果結果集是以其他方法產生的，則返回 null

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getObject

Object getObject(int columnIndex,
                 Map<String,Class<?>> map)
                 throws SQLException

以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。如果值為 SQL NULL，則驅動程序返回一個 Java null。此方法使用給定的 Map 物件作為正在獲取的 SQL 結構化或獨特型別的自定義映射關係。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

map - 一個 java.util.Map 物件，包含從 SQL 型別名稱到 Java 程式語言中類別的映射關係

返回：

表示 SQL 值的 Java 程式語言中的 Object

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getRef

Ref getRef(int columnIndex)
           throws SQLException

以 Java 程式語言中 Ref 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

表示 SQL REF 值的 Ref 物件

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getBlob

Blob getBlob(int columnIndex)
             throws SQLException

以 Java 程式語言中 Blob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

表示指定列中的 SQL BLOB 值的 BLOB 物件

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getClob

Clob getClob(int columnIndex)
             throws SQLException

以 Java 程式語言中 Clob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

表示指定列中的 SQL Clob 值的 Clob 物件

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getArray

Array getArray(int columnIndex)
               throws SQLException

以 Java 程式語言中 Array 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

表示指定列中的 SQL Array 值的 Array 物件

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getObject

Object getObject(String columnLabel,
                 Map<String,Class<?>> map)
                 throws SQLException

以 Java 程式語言中 Object 的形式獲取此 ResultSet 物件的當前行中指定列的值。如果值為 SQL NULL，則驅動程序返回一個 Java null。此方法使用指定的 Map 物件自定義映射關係（如果合適）。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

map - 套件含從 SQL 型別名稱到 Java 程式語言中類別的映射關係的 java.util.Map 物件

返回：

表示指定列中的 SQL 值的 Object

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getRef

Ref getRef(String columnLabel)
           throws SQLException

以 Java 程式語言中 Ref 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

表示指定列中 SQL Ref 值的 Ref 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getBlob

Blob getBlob(String columnLabel)
             throws SQLException

以 Java 程式語言中 Blob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

表示指定列中 SQL Blob 值的 Blob 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getClob

Clob getClob(String columnLabel)
             throws SQLException

以 Java 程式語言中 Clob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

表示指定列中 SQL CLOB 值的 Clob 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getArray

Array getArray(String columnLabel)
               throws SQLException

以 Java 程式語言中 Array 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

表示指定列中 SQL ARRAY 值的 ARRAY 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getDate

Date getDate(int columnIndex,
             Calendar cal)
             throws SQLException

以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構日期的適當毫秒值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

cal - 在建構日期時使用的 java.util.Calendar 物件

返回：

java.sql.Date 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getDate

Date getDate(String columnLabel,
             Calendar cal)
             throws SQLException

以 Java 程式語言中 java.sql.Date 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構日期的適當毫秒值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

cal - 在建構日期時使用的 java.util.Calendar 物件

返回：

java.sql.Date 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getTime

Time getTime(int columnIndex,
             Calendar cal)
             throws SQLException

以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構時間的適當毫秒值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

cal - 在建構時間時使用的 java.util.Calendar 物件

返回：

java.sql.Time 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getTime

Time getTime(String columnLabel,
             Calendar cal)
             throws SQLException

以 Java 程式語言中 java.sql.Time 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構時間的適當毫秒值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

cal - 在建構時間時使用的 java.util.Calendar 物件

返回：

java.sql.Time 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getTimestamp

Timestamp getTimestamp(int columnIndex,
                       Calendar cal)
                       throws SQLException

以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構時間戳的適當毫秒值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

cal - 在建構時間戳時使用的 java.util.Calendar 物件

返回：

java.sql.Timestamp 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getTimestamp

Timestamp getTimestamp(String columnLabel,
                       Calendar cal)
                       throws SQLException

以 Java 程式語言中 java.sql.Timestamp 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。如果底層資料庫未存儲時區資訊，則此方法使用給定日曆建構時間戳的適當毫秒值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

cal - 在建構日期時使用的 java.util.Calendar 物件

返回：

java.sql.Timestamp 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.2

getURL

URL getURL(int columnIndex)
           throws SQLException

以 Java 程式語言中 java.net.URL 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 索引，其中第一個列是 1、第二個列是 2，……

返回：

java.net.URL 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法或 URL 是錯誤的

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getURL

URL getURL(String columnLabel)
           throws SQLException

以 Java 程式語言中 java.net.URL 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

java.net.URL 物件形式的列值；如果值為 SQL NULL，則返回值為 Java 程式語言中的 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法，或者 URL 是錯誤的

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateRef

void updateRef(int columnIndex,
               Ref x)
               throws SQLException

用 java.sql.Ref 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateRef

void updateRef(String columnLabel,
               Ref x)
               throws SQLException

用 java.sql.Ref 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateBlob

void updateBlob(int columnIndex,
                Blob x)
                throws SQLException

用 java.sql.Blob 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateBlob

void updateBlob(String columnLabel,
                Blob x)
                throws SQLException

用 java.sql.Blob 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateClob

void updateClob(int columnIndex,
                Clob x)
                throws SQLException

用 java.sql.Clob 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateClob

void updateClob(String columnLabel,
                Clob x)
                throws SQLException

用 java.sql.Clob 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateArray

void updateArray(int columnIndex,
                 Array x)
                 throws SQLException

用 java.sql.Array 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

updateArray

void updateArray(String columnLabel,
                 Array x)
                 throws SQLException

用 java.sql.Array 值更新指定列。更新方法用於更新當前行或插入行中的列值，並不會更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

getRowId

RowId getRowId(int columnIndex)
               throws SQLException

以 Java 程式語言中 java.sql.RowId 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果該值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getRowId

RowId getRowId(String columnLabel)
               throws SQLException

以 Java 程式語言中 java.sql.RowId 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果該值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateRowId

void updateRowId(int columnIndex,
                 RowId x)
                 throws SQLException

用 RowId 值更新指定列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateRowId

void updateRowId(String columnLabel,
                 RowId x)
                 throws SQLException

用 RowId 值更新指定的列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getHoldability

int getHoldability()
                   throws SQLException

獲取此 ResultSet 物件的可保存性

返回：

ResultSet.HOLD_CURSORS_OVER_COMMIT 或 ResultSet.CLOSE_CURSORS_AT_COMMIT

拋出：

SQLException - 如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

從以下版本開始：

1.6

isClosed

boolean isClosed()
                 throws SQLException

獲取此 ResultSet 物件是否已關閉。如果已經在 ResultSet 上調用了 close 方法，或者 ResultSet 自動關閉，則 ResultSet 已關閉。

返回：

如果此 ResultSet 物件已關閉，則返回 true；如果它仍然是打開的，則返回 false

拋出：

SQLException - 如果發生資料庫存取錯誤

從以下版本開始：

1.6

updateNString

void updateNString(int columnIndex,
                   String nString)
                   throws SQLException

用 String 值更新指定的列。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時使用該方法。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

nString - 要更新的列值

拋出：

SQLException - 如果 columnIndex 無效；如果驅動程序不支持國家字元集 (national character set)；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；結果集共時性為 CONCUR_READ_ONLY 或發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNString

void updateNString(String columnLabel,
                   String nString)
                   throws SQLException

用 String 值更新指定的列。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時使用該方法。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

nString - 要更新的列值

拋出：

SQLException - 如果 columnLabel 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；結果集共時性為 CONCUR_READ_ONLY 或發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(int columnIndex,
                 NClob nClob)
                 throws SQLException

用 java.sql.NClob 值更新指定的列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

nClob - 要更新的列值

拋出：

SQLException - 如果 columnIndex 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(String columnLabel,
                 NClob nClob)
                 throws SQLException

用 java.sql.NClob 值更新指定的列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

nClob - 要更新的列值

拋出：

SQLException - 如果 columnLabel 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNClob

NClob getNClob(int columnIndex)
               throws SQLException

以 Java 程式語言中 NClob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

表示指定列中 SQL NCLOB 值的 NClob 物件

拋出：

SQLException - 如果 columnIndex 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法或發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNClob

NClob getNClob(String columnLabel)
               throws SQLException

以 Java 程式語言中 NClob 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

表示指定列中 SQL NCLOB 值的 NClob 物件

拋出：

SQLException - 如果 columnLabel 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法或發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getSQLXML

SQLXML getSQLXML(int columnIndex)
                 throws SQLException

以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

一個映射 SQL XML 值的 SQLXML 物件

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getSQLXML

SQLXML getSQLXML(String columnLabel)
                 throws SQLException

以 Java 程式語言中 java.sql.SQLXML 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

一個映射 SQL XML 值的 SQLXML 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateSQLXML

void updateSQLXML(int columnIndex,
                  SQLXML xmlObject)
                  throws SQLException

用 java.sql.SQLXML 值更新指定列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

xmlObject - 要更新的列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法；沒有為 SQLXML 物件關閉 java.xml.transform.Result、Writer 或 OutputStream；如果在處理 XML 值的過程中發生錯誤或結果集共時性為 CONCUR_READ_ONLY。該異常的 getCause 方法可以提供更詳細的異常資訊，例如，如果該串流不包含有效的 XML。

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateSQLXML

void updateSQLXML(String columnLabel,
                  SQLXML xmlObject)
                  throws SQLException

用 java.sql.SQLXML 值更新指定的列。更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

xmlObject - 列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；在已關閉的結果集上調用此方法；沒有為 SQLXML 物件關閉 java.xml.transform.Result、Writer 或 OutputStream；如果在處理 XML 值的過程中發生錯誤或結果集共時性為 CONCUR_READ_ONLY。該異常的 getCause 方法可能提供更詳細的異常資訊，例如，如果該串流不包含有效的 XML。

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNString

String getNString(int columnIndex)
                  throws SQLException

以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

列值；如果該值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNString

String getNString(String columnLabel)
                  throws SQLException

以 Java 程式語言中 String 的形式獲取此 ResultSet 物件的當前行中指定列的值。存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

列值；如果該值為 SQL NULL，則返回值為 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNCharacterStream

Reader getNCharacterStream(int columnIndex)
                           throws SQLException

以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

返回：

包含該列值的 java.io.Reader 物件；如果該值為 SQL NULL，則返回 Java 程式語言中的值 null。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

getNCharacterStream

Reader getNCharacterStream(String columnLabel)
                           throws SQLException

以 java.io.Reader 物件的形式獲取此 ResultSet 物件的當前行中指定列的值。存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

返回：

包含該列值的 java.io.Reader 物件；如果該值為 SQL NULL，則返回 Java 程式語言中的值 null

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNCharacterStream

void updateNCharacterStream(int columnIndex,
                            Reader x,
                            long length)
                            throws SQLException

用字元串流值更新指定的列，該值將具有指定的位元組數。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNCharacterStream

void updateNCharacterStream(String columnLabel,
                            Reader reader,
                            long length)
                            throws SQLException

用字元串流值更新指定的列，該值將具有指定的位元組數。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含新列值的 java.io.Reader 物件

length - 串流長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateAsciiStream

void updateAsciiStream(int columnIndex,
                       InputStream x,
                       long length)
                       throws SQLException

用 ascii 串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBinaryStream

void updateBinaryStream(int columnIndex,
                        InputStream x,
                        long length)
                        throws SQLException

用二進制串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateCharacterStream

void updateCharacterStream(int columnIndex,
                           Reader x,
                           long length)
                           throws SQLException

用字元串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateAsciiStream

void updateAsciiStream(String columnLabel,
                       InputStream x,
                       long length)
                       throws SQLException

用 ascii 串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBinaryStream

void updateBinaryStream(String columnLabel,
                        InputStream x,
                        long length)
                        throws SQLException

用二進制串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

length - 串流長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateCharacterStream

void updateCharacterStream(String columnLabel,
                           Reader reader,
                           long length)
                           throws SQLException

用字元串流值更新指定的列，該值將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含新列值的 java.io.Reader 物件

length - 串流長度

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBlob

void updateBlob(int columnIndex,
                InputStream inputStream,
                long length)
                throws SQLException

使用給定輸入串流更新指定的列，該串流將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

inputStream - 套件含用來設置參數值的資料的物件。

length - 參數資料中的位元組數。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBlob

void updateBlob(String columnLabel,
                InputStream inputStream,
                long length)
                throws SQLException

使用給定輸入串流更新指定列，該串流將具有指定的位元組數。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

inputStream - 套件含用來設置參數值的資料的物件。

length - 參數資料中的位元組數。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateClob

void updateClob(int columnIndex,
                Reader reader,
                long length)
                throws SQLException

使用給定的 Reader 物件更新指定列，該物件是給定的字元長度數目。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

reader - 套件含用來設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateClob

void updateClob(String columnLabel,
                Reader reader,
                long length)
                throws SQLException

使用給定的 Reader 物件更新指定列，該物件是給定的字元長度數目。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含用來設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(int columnIndex,
                 Reader reader,
                 long length)
                 throws SQLException

使用給定的 Reader 物件更新指定的列，該物件是給定的字元長度數目。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

reader - 套件含用來設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 columnIndex 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；如果發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(String columnLabel,
                 Reader reader,
                 long length)
                 throws SQLException

使用給定的 Reader 物件更新指定的列，該物件是給定的字元長度數目。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含用來設置參數值的資料的物件。

length - 參數資料中的字元數。

拋出：

SQLException - 如果 columnLabel 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；如果發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNCharacterStream

void updateNCharacterStream(int columnIndex,
                            Reader x)
                            throws SQLException

用字元串流值更新指定的列。將根據需要從串流中讀取資料，一直讀取到串流末尾。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateNCharacterStream 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNCharacterStream

void updateNCharacterStream(String columnLabel,
                            Reader reader)
                            throws SQLException

用字元串流值更新指定的列。將根據需要從串流中讀取資料，一直讀取到串流末尾。驅動程序執行從 Java 字元格式到資料庫中國家字元集的必要轉換。更新 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時可使用此方法。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateNCharacterStream 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含新列值的 java.io.Reader 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateAsciiStream

void updateAsciiStream(int columnIndex,
                       InputStream x)
                       throws SQLException

用 ascii 串流值更新指定的列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateAsciiStream 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBinaryStream

void updateBinaryStream(int columnIndex,
                        InputStream x)
                        throws SQLException

用二進制串流值更新指定的列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateBinaryStream 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateCharacterStream

void updateCharacterStream(int columnIndex,
                           Reader x)
                           throws SQLException

用字元串流值更新指定的列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateCharacterStream 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

x - 新列值

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateAsciiStream

void updateAsciiStream(String columnLabel,
                       InputStream x)
                       throws SQLException

用 ascii 串流值更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateAsciiStream 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBinaryStream

void updateBinaryStream(String columnLabel,
                        InputStream x)
                        throws SQLException

用二進制串流值更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateBinaryStream 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

x - 新列值

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateCharacterStream

void updateCharacterStream(String columnLabel,
                           Reader reader)
                           throws SQLException

用字元串流值更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateCharacterStream 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含新列值的 java.io.Reader 物件

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBlob

void updateBlob(int columnIndex,
                InputStream inputStream)
                throws SQLException

使用給定輸入串流值更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateBlob 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

inputStream - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateBlob

void updateBlob(String columnLabel,
                InputStream inputStream)
                throws SQLException

使用給定輸入串流值更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateBlob 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

inputStream - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateClob

void updateClob(int columnIndex,
                Reader reader)
                throws SQLException

使用給定的 Reader 物件更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateClob 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnIndex 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateClob

void updateClob(String columnLabel,
                Reader reader)
                throws SQLException

使用給定的 Reader 物件更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateClob 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnLabel 無效；如果發生資料庫存取錯誤；結果集共時性為 CONCUR_READ_ONLY 或在已關閉的結果集上調用此方法

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(int columnIndex,
                 Reader reader)
                 throws SQLException

使用給定的 Reader 物件更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateNClob 是否更有效。

參數：

columnIndex - 第一個列是 1，第二個列是 2，……

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnIndex 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；如果發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6

updateNClob

void updateNClob(String columnLabel,
                 Reader reader)
                 throws SQLException

使用給定的 Reader 物件更新指定列。將根據需要從串流中讀取資料，一直讀取到串流末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

更新方法用於更新當前行或插入行中的列值。更新方法不更新底層資料庫；更新資料庫要調用 updateRow 或 insertRow 方法。

註：請參考 JDBC 驅動程序文檔，以確定使用帶長度參數的 updateNClob 是否更有效。

參數：

columnLabel - 使用 SQL AS 子句指定的列標籤。如果未指定 SQL AS 子句，則標籤是列名稱

reader - 套件含用來設置參數值的資料的物件。

拋出：

SQLException - 如果 columnLabel 無效；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；在已關閉的結果集上調用此方法；如果發生資料庫存取錯誤或結果集共時性為 CONCUR_READ_ONLY

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.6