IPreparedStatement 介面

定義

命名空間:: Java.Sql

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一個代表預先編譯 SQL 陳述式的物件。

[Android.Runtime.Register("java/sql/PreparedStatement", "", "Java.Sql.IPreparedStatementInvoker")]
public interface IPreparedStatement : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IStatement

[<Android.Runtime.Register("java/sql/PreparedStatement", "", "Java.Sql.IPreparedStatementInvoker")>]
type IPreparedStatement = interface
    interface IStatement
    interface IWrapper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

衍生: Java.Sql.ICallableStatement

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable IStatement IWrapper IDisposable

備註

一個代表預先編譯 SQL 陳述式的物件。

SQL 陳述式會預先編譯並儲存在物件中 PreparedStatement 。此物件可被用來有效執行此語句多次。

<B>註：</B> 設定 IN 參數值的設定器方法（setShort、 setString、等）必須指定與輸入參數定義 SQL 型態相容的型別。例如，如果 IN 參數的 SQL 型別 INTEGER為，則應使用該方法 setInt 。

若需要任意參數型別轉換，則應與目標 SQL 型別搭配使用該方法 setObject 。

在以下設定參數的範例中，代表 con 一個主動連接：

PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                                SET SALARY = ? WHERE ID = ?");
              pstmt.setBigDecimal(1, 153833.00)
              pstmt.setInt(2, 110592)

Java 文件 java.sql.PreparedStatement。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

欄位

名稱	Description
CloseAllResults	常數表示所有 `ResultSet` 先前保持開啟的物件在呼叫 `getMoreResults`時應為閉合。 (繼承來源 IStatement)
CloseCurrentResult	常數表示 `ResultSet` 當前物件在呼叫 `getMoreResults`時應為閉合。 (繼承來源 IStatement)
ExecuteFailed	常數表示執行批次敘述時發生錯誤。 (繼承來源 IStatement)
KeepCurrentResult	常數表示 `ResultSet` 當前物件在呼叫 `getMoreResults`時不應閉合。 (繼承來源 IStatement)
NoGeneratedKeys	這個常數表示產生的金鑰不應被公開可取。 (繼承來源 IStatement)
ReturnGeneratedKeys	這個常數表示產生的金鑰應該可供檢索。 (繼承來源 IStatement)
SuccessNoInfo	常數表示批次敘述成功執行，但無法計算受影響的列數。 (繼承來源 IStatement)

屬性

名稱	Description
Connection	取得 `Connection` 創建此陳述的物件。 (繼承來源 IStatement)
FetchDirection	取得從此陳述產生的 s 筆列 `ResultSet`的預設方向。 (繼承來源 IStatement)
FetchSize	取得從此陳述句回傳物件的預設 `ResultSet` 列數。 (繼承來源 IStatement)
GeneratedKeys	回傳執行此語句所自動產生的金鑰。 (繼承來源 IStatement)
Handle	取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
IsClosed	如果該陳述句已被關閉，則回傳真，否則回傳 false。 (繼承來源 IStatement)
JniIdentityHashCode	回傳包裹實例的 `java.lang.System.identityHashCode()` 值。 (繼承來源 IJavaPeerable)
JniManagedPeerState	管理貴族的狀況。 (繼承來源 IJavaPeerable)
JniObjectReferenceControlBlock	一個代表預先編譯 SQL 陳述式的物件。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取與召喚支援。 (繼承來源 IJavaPeerable)
MaxFieldSize	取得可從字元型與二進位型欄位回傳的最大位元組數，該欄位由 `ResultSet` 此陳述衍生出。 (繼承來源 IStatement)
MaxRows	從此陳述產生時，會得到 a `ResultSet` 能包含的最大列數。 (繼承來源 IStatement)
MetaData	回傳`ResultSetMetaDataResultSet`描述的，該將由執行 `PreparedStatement`所產生。
MoreResults	接著看這個陳述的下一個結果。 (繼承來源 IStatement)
ParameterMetaData	取得關於參數 `PreparedStatement`的資訊。
PeerReference	回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable)
Poolable	如果此陳述是可池的，則回傳真，否則為假。 (繼承來源 IStatement)
QueryTimeout	取得該語句執行時間的逾時值。 (繼承來源 IStatement)
ResultSet	會得到目前的結果。 (繼承來源 IStatement)
ResultSetConcurrency	取得由此陳述產生的物件的並行設定 `ResultSet` 。 (繼承來源 IStatement)
ResultSetHoldability	取得此陳述產生物件的游標保持設定 `ResultSet` 。 (繼承來源 IStatement)
ResultSetType	從此陳述推導 `ResultSet` 出 s 的型別設定 `ResultSet`。 (繼承來源 IStatement)
UpdateCount	如果目前結果不是 `ResultSet`，則會獲得更新次數。 (繼承來源 IStatement)
Warnings	取得本聲明中第一個 `SQLWarning` 由呼叫報告的資訊。 (繼承來源 IStatement)

方法

名稱	Description
AddBatch()	為該 `PreparedStatement` 物件的指令批次新增一組參數。
AddBatch(String)	將該 SQL 指令加入該物件目前的指令 `Statement` 清單。 (繼承來源 IStatement)
Cancel()	如果資料庫管理系統（DBMS）和驅動程式都支援中止 SQL 陳述式，則會取消此 `Statement` 物件。 (繼承來源 IStatement)
ClearBatch()	會將此 `Statement` 物件目前的 SQL 指令清單清空。 (繼承來源 IStatement)
ClearParameters()	立刻清除目前的參數值。
ClearWarnings()	清除所有 `Statement` 報告的警告。 (繼承來源 IStatement)
Close()	立即釋放該 `Statement` 物件的資料庫與 JDBC 資源，而非等待自動關閉後才釋放。 (繼承來源 IStatement)
Disposed()	當實例被處理後才被召喚。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果沒有未解決的參考資料，則 `Dispose()`呼叫;否則，則不做任何事。 (繼承來源 IJavaPeerable)
Execute()	執行此 `PreparedStatement` 物件中的 SQL 陳述句，該陳述可以是任何類型的 SQL 陳述。
Execute(String, Int32)	執行給定的 SQL 陳述式，可能回傳多個結果，並向驅動程式發出信號，表示任何自動產生的金鑰都應開放以供檢索。 (繼承來源 IStatement)
Execute(String, Int32[])	執行給定的 SQL 陳述句，該陳述句可能回傳多個結果，並向驅動程式提示該陣列中自動產生的金鑰應可供檢索。 (繼承來源 IStatement)
Execute(String, String[])	執行給定的 SQL 陳述句，該陳述句可能回傳多個結果，並向驅動程式提示該陣列中自動產生的金鑰應可供檢索。 (繼承來源 IStatement)
Execute(String)	執行給定的 SQL 陳述句，該陳述句可能返回多個結果。 (繼承來源 IStatement)
ExecuteBatch()	將一批指令提交到資料庫執行，若所有指令都成功執行，則回傳一組更新次數陣列。 (繼承來源 IStatement)
ExecuteQuery()	在此物件中執行 SQL 查詢 `PreparedStatement` ，並回傳 `ResultSet` 由查詢產生的物件。
ExecuteQuery(String)	執行給定的 SQL 陳述句，該陳述句回傳單一 `ResultSet` 物件。 (繼承來源 IStatement)
ExecuteUpdate()	執行此 `PreparedStatement` 物件中的 SQL 陳述式，必須是 SQL 資料操作語言（DML）陳述式，例如 `INSERT`， `UPDATE` 或 `DELETE`;或是不回傳任何內容的 SQL 陳述式，如 DDL 陳述式。
ExecuteUpdate(String, Int32)	執行給定的 SQL 陳述句，並以指定旗標向驅動程式發出信號，告知該 `Statement` 物件產生的自動產生金鑰是否應公開供檢索。 (繼承來源 IStatement)
ExecuteUpdate(String, Int32[])	執行給定的 SQL 陳述式，並通知驅動程式應將該陣列中自動產生的金鑰開放以供檢索。 (繼承來源 IStatement)
ExecuteUpdate(String, String[])	執行給定的 SQL 陳述式，並通知驅動程式應將該陣列中自動產生的金鑰開放以供檢索。 (繼承來源 IStatement)
ExecuteUpdate(String)	執行給定的 SQL 陳述句，該陳述式可能是 `INSERT`、 `UPDATE`、或 `DELETE` 陳述式，或是不回傳任何內容的 SQL 陳述式，例如 SQL DDL 陳述式。 (繼承來源 IStatement)
Finalized()	當實例完成後才會被通知。 (繼承來源 IJavaPeerable)
GetMoreResults(Int32)	移動到該`Statement`物件的下一個結果，根據指定標誌指定的指令處理任何當前`ResultSet`物件，若下一個結果是`ResultSet`物件則返回`true`。 (繼承來源 IStatement)
IsWrapperFor(Class)	如果這要麼實作了介面參數，要麼直接或間接地為一個包含介面參數的物件包裝，則回傳為真。 (繼承來源 IWrapper)
SetArray(Int32, IArray)	將指定參數設定為給定 `java.sql.Array` 物件。
SetAsciiStream(Int32, Stream, Int32)	將指定參數設定為給定的輸入串流，該串流將擁有指定的位元組數。
SetAsciiStream(Int32, Stream, Int64)	將指定參數設定為給定的輸入串流，該串流將擁有指定的位元組數。
SetAsciiStream(Int32, Stream)	設定指定的參數為給定的輸入資料流。
SetBigDecimal(Int32, BigDecimal)	將指定參數設定為給定 `java.math.BigDecimal` 值。
SetBinaryStream(Int32, Stream, Int32)	將指定參數設定為給定的輸入串流，該串流將擁有指定的位元組數。
SetBinaryStream(Int32, Stream, Int64)	將指定參數設定為給定的輸入串流，該串流將擁有指定的位元組數。
SetBinaryStream(Int32, Stream)	設定指定的參數為給定的輸入資料流。
SetBlob(Int32, IBlob)	將指定參數設定為給定 `java.sql.Blob` 物件。
SetBlob(Int32, Stream, Int64)	將指定參數設定為物件 `InputStream` 。
SetBlob(Int32, Stream)	將指定參數設定為物件 `InputStream` 。
SetBoolean(Int32, Boolean)	將指定參數設為給定的 Java `boolean` 值。
SetByte(Int32, SByte)	將指定參數設為給定的 Java `byte` 值。
SetBytes(Int32, Byte[])	將指定參數設為給定的 Java 位元組陣列。
SetCharacterStream(Int32, Reader, Int32)	將指定參數設為給定 `Reader` 的物件，即給定的字元數。
SetCharacterStream(Int32, Reader, Int64)	將指定參數設為給定 `Reader` 的物件，即給定的字元數。
SetCharacterStream(Int32, Reader)	將指定參數設定為給定 `Reader` 物件。
SetClob(Int32, IClob)	將指定參數設定為給定 `java.sql.Clob` 物件。
SetClob(Int32, Reader, Int64)	將指定參數設定為物件 `Reader` 。
SetClob(Int32, Reader)	將指定參數設定為物件 `Reader` 。
SetCursorName(String)	將 SQL 游標名稱設定為給定 `String`的，後續 `Statement` 物件 `execute` 方法會使用此名稱。 (繼承來源 IStatement)
SetDate(Int32, Date, Calendar)	使用指定`Calendar`物件將指定參數設為給定`java.sql.Date`值。
SetDate(Int32, Date)	將指定參數設定為 `java.sql.Date` 執行該應用程式的虛擬機器的預設時區值。
SetDouble(Int32, Double)	將指定參數設為給定的 Java `double` 值。
SetEscapeProcessing(Boolean)	開啟或關閉逃逸處理。 (繼承來源 IStatement)
SetFloat(Int32, Single)	將指定參數設為給定的 Java `float` 值。
SetInt(Int32, Int32)	將指定參數設為給定的 Java `int` 值。
SetJniIdentityHashCode(Int32)	將回傳的值設為 `JniIdentityHashCode`。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	一個代表預先編譯 SQL 陳述式的物件。 (繼承來源 IJavaPeerable)
SetLong(Int32, Int64)	將指定參數設為給定的 Java `long` 值。
SetNCharacterStream(Int32, Reader, Int64)	將指定參數設定為物件 `Reader` 。
SetNCharacterStream(Int32, Reader)	將指定參數設定為物件 `Reader` 。
SetNClob(Int32, INClob)	將指定參數設定為物件 `java.sql.NClob` 。
SetNClob(Int32, Reader, Int64)	將指定參數設定為物件 `Reader` 。
SetNClob(Int32, Reader)	將指定參數設定為物件 `Reader` 。
SetNString(Int32, String)	將指定的參數設為給定 `String` 物件。
SetNull(Int32, Int32, String)	將指定參數設為 SQL `NULL`。
SetNull(Int32, Int32)	將指定參數設為 SQL `NULL`。
SetObject(Int32, Object, Int32, Int32)	設定指定參數的值與給定物件。
SetObject(Int32, Object, Int32)	設定指定參數的值與給定物件。
SetObject(Int32, Object)	使用給定物件，設定指定之參數的值。
SetPeerReference(JniObjectReference)	將回傳的值設為 `PeerReference`。 (繼承來源 IJavaPeerable)
SetRef(Int32, IRef)	將指定參數設定為給定 `REF(<structured-type>)` 值。
SetRowId(Int32, IRowId)	將指定參數設定為給定 `java.sql.RowId` 物件。
SetShort(Int32, Int16)	將指定參數設為給定的 Java `short` 值。
SetSQLXML(Int32, ISQLXML)	將指定參數設定為給定 `java.sql.SQLXML` 物件。
SetString(Int32, String)	將指定參數設為給定的 Java `String` 值。
SetTime(Int32, Time, Calendar)	使用指定`Calendar`物件將指定參數設為給定`java.sql.Time`值。
SetTime(Int32, Time)	將指定參數設定為給定 `java.sql.Time` 值。
SetTimestamp(Int32, Timestamp, Calendar)	使用指定`Calendar`物件將指定參數設為給定`java.sql.Timestamp`值。
SetTimestamp(Int32, Timestamp)	將指定參數設定為給定 `java.sql.Timestamp` 值。
SetUnicodeStream(Int32, Stream, Int32)	已淘汰. 將指定參數設定為給定的輸入串流，該串流將擁有指定的位元組數。
SetURL(Int32, URL)	將指定參數設定為給定 `java.net.URL` 值。
UnregisterFromRuntime()	取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable)
Unwrap(Class)	回傳一個物件，實作給定介面，允許存取非標準方法，或代理未暴露的標準方法。 (繼承來源 IWrapper)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	一個代表預先編譯 SQL 陳述式的物件。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於