IConnection.PrepareStatement 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| PrepareStatement(String) |
建立 |
| PrepareStatement(String, Int32) |
建立 |
| PrepareStatement(String, Int32[]) |
建立 |
| PrepareStatement(String, String[]) |
建立 |
| PrepareStatement(String, Int32, Int32) |
建立 |
| PrepareStatement(String, Int32, Int32, Int32) |
建立 |
PrepareStatement(String)
建立 PreparedStatement 一個物件，用來將參數化的 SQL 語句傳送到資料庫。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string -> Java.Sql.IPreparedStatement參數
- sql
- String
一個可能包含一個或多個「？」的 SQL 陳述句IN 參數佔位符
傳回
一個新的預設 PreparedStatement 物件，包含預先編譯好的 SQL 語句
- 屬性
例外狀況
如果資料庫存取有問題。
備註
建立 PreparedStatement 一個物件，用來將參數化的 SQL 語句傳送到資料庫。
一個有或無 IN 參數的 SQL 陳述式都可以預先編譯並儲存在物件中 PreparedStatement 。 此物件可被用來有效執行此語句多次。
<B>註：</B> 此方法優化用於處理受益於預編譯的參數化 SQL 語句。 若驅動程式支援預編譯，該方法 prepareStatement 會將語句送至資料庫進行預編譯。 有些驅動程式可能不支援預編譯。 在這種情況下，該語句可能只有在 PreparedStatement 物件被執行前才會傳送到資料庫。 這對使用者沒有直接影響;不過，這會影響哪些方法會拋出特定 SQLException 物件。
使用回傳 PreparedStatement 物件建立的結果集預設為型別 TYPE_FORWARD_ONLY ，並行層級為 CONCUR_READ_ONLY。 所建立結果集的可保持性可透過呼叫 #getHoldability來判定。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
PrepareStatement(String, Int32)
建立 PreparedStatement 一個預設物件，具備擷取自動產生鍵的能力。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int autoGeneratedKeys);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int -> Java.Sql.IPreparedStatement參數
- sql
- String
一個可能包含一個或多個「？」的 SQL 陳述句IN 參數佔位符
- autoGeneratedKeys
- Int32
一個指示是否應該回傳自動產生金鑰的旗標;其中一或Statement.RETURN_GENERATED_KEYSStatement.NO_GENERATED_KEYS
傳回
一個包含 PreparedStatement 預先編譯的 SQL 陳述式的新物件，具備回傳自動產生金鑰的能力
- 屬性
例外狀況
如果資料庫存取有問題。
備註
建立 PreparedStatement 一個預設物件，具備擷取自動產生鍵的能力。 給定的常數告訴驅動程式是否應該開放自動產生的金鑰可供檢索。 若 SQL 陳述式不是陳述式，或是 INSERT 能回傳自動產生金鑰的 SQL 陳述式（此類陳述式清單依廠商特定）則忽略此參數。
<B>註：</B> 此方法優化用於處理受益於預編譯的參數化 SQL 語句。 若驅動程式支援預編譯，該方法 prepareStatement 會將語句送至資料庫進行預編譯。 有些驅動程式可能不支援預編譯。 在這種情況下，該語句可能只有在 PreparedStatement 物件被執行前才會傳送到資料庫。 這對使用者沒有直接影響;但這會影響哪些方法拋出特定的 SQLExceptions。
使用回傳 PreparedStatement 物件建立的結果集預設為型別 TYPE_FORWARD_ONLY ，並行層級為 CONCUR_READ_ONLY。 所建立結果集的可保持性可透過呼叫 #getHoldability來判定。
在 1.4 版本加入。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String, int)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
PrepareStatement(String, Int32[])
建立 PreparedStatement 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int[]? columnIndexes);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int[] -> Java.Sql.IPreparedStatement參數
- sql
- String
一個可能包含一個或多個「？」的 SQL 陳述句IN 參數佔位符
- columnIndexes
- Int32[]
一組欄位索引陣列，指示應從插入的列回傳哪些欄位
傳回
一個包含 PreparedStatement 預先編譯語句的新物件，能夠回傳由指定欄位索引陣列指定的自動產生鍵
- 屬性
例外狀況
如果存取資料庫時發生問題。
備註
建立 PreparedStatement 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。 此陣列包含目標資料表中包含應公開的自動產生鍵的欄位索引。 若 SQL 語句不是語句，或是 INSERT 能回傳自動產生金鑰的 SQL 語句（此類語句清單為廠商專屬），驅動程式會忽略陣列。
一個有或沒有 IN 參數的 SQL 陳述式都可以預先編譯並儲存在物件中 PreparedStatement 。 此物件可被用來有效執行此語句多次。
<B>註：</B> 此方法優化用於處理受益於預編譯的參數化 SQL 語句。 若驅動程式支援預編譯，該方法 prepareStatement 會將語句送至資料庫進行預編譯。 有些驅動程式可能不支援預編譯。 在這種情況下，該語句可能只有在 PreparedStatement 物件被執行前才會傳送到資料庫。 這對使用者沒有直接影響;但這會影響哪些方法拋出特定的 SQLExceptions。
使用回傳 PreparedStatement 物件建立的結果集預設為型別 TYPE_FORWARD_ONLY ，並行層級為 CONCUR_READ_ONLY。 所建立結果集的可保持性可透過呼叫 #getHoldability來判定。
在 1.4 版本加入。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String, int[])。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
PrepareStatement(String, String[])
建立 PreparedStatement 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayLjava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, string[]? columnNames);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayLjava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * string[] -> Java.Sql.IPreparedStatement參數
- sql
- String
一個可能包含一個或多個「？」的 SQL 陳述句IN 參數佔位符
- columnNames
- String[]
一組欄位名稱陣列，表示應從插入的列回傳哪些欄位
傳回
一個包含 PreparedStatement 預先編譯語句的新物件，能夠回傳由給定欄位名稱陣列指定的自動產生鍵
- 屬性
例外狀況
如果存取資料庫時發生問題。
備註
建立 PreparedStatement 一個預設物件，能夠回傳由指定陣列指定的自動產生鍵。 此陣列包含目標資料表中包含應回傳的自動產生鍵的欄位名稱。 若 SQL 語句不是語句，或是 INSERT 能回傳自動產生金鑰的 SQL 語句（此類語句清單為廠商專屬），驅動程式會忽略陣列。
一個有或沒有 IN 參數的 SQL 陳述式都可以預先編譯並儲存在物件中 PreparedStatement 。 此物件可被用來有效執行此語句多次。
<B>註：</B> 此方法優化用於處理受益於預編譯的參數化 SQL 語句。 若驅動程式支援預編譯，該方法 prepareStatement 會將語句送至資料庫進行預編譯。 有些驅動程式可能不支援預編譯。 在這種情況下，該語句可能只有在 PreparedStatement 物件被執行前才會傳送到資料庫。 這對使用者沒有直接影響;但這會影響哪些方法拋出特定的 SQLExceptions。
使用回傳 PreparedStatement 物件建立的結果集預設為型別 TYPE_FORWARD_ONLY ，並行層級為 CONCUR_READ_ONLY。 所建立結果集的可保持性可透過呼叫 #getHoldability來判定。
在 1.4 版本加入。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String, java.lang.String[])。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
PrepareStatement(String, Int32, Int32)
建立 PreparedStatement 一個物件，能產生 ResultSet 具有指定類型與並行性的物件。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;II)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int resultSetType, int resultSetConcurrency);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;II)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int * int -> Java.Sql.IPreparedStatement參數
- sql
- String
一個 String 物件，該物件是要傳送到資料庫的 SQL 陳述式;可能包含一個或多個 '？'在參數中
- resultSetType
- Int32
結果集類型;其中一、ResultSet.TYPE_FORWARD_ONLYResultSet.TYPE_SCROLL_INSENSITIVE或ResultSet.TYPE_SCROLL_SENSITIVE
- resultSetConcurrency
- Int32
一種並行型態;其中一或ResultSet.CONCUR_READ_ONLYResultSet.CONCUR_UPDATABLE
傳回
一個新的 PreparedStatement 物件，包含預先編譯好的 SQL 語句，該語句將產生 ResultSet 具有指定類型與並行性的物件
- 屬性
例外狀況
如果存取資料庫時發生問題。
備註
建立 PreparedStatement 一個物件，能產生 ResultSet 具有指定類型與並行性的物件。 此方法與 prepareStatement 上述方法相同，但允許覆蓋預設結果集類型與並行性。 所建立結果集的可保持性可透過呼叫 #getHoldability來判定。
在 1.2 版本中加入。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String, int, int)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
PrepareStatement(String, Int32, Int32, Int32)
建立 PreparedStatement 一個物件，能產生 ResultSet 具有特定類型、並行性及可hold性的物件。
[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;III)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability);[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;III)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int * int * int -> Java.Sql.IPreparedStatement參數
- sql
- String
一個 String 物件，該物件是要傳送到資料庫的 SQL 陳述式;可能包含一個或多個 '？'在參數中
- resultSetType
- Int32
以下 ResultSet 常數之一： ResultSet.TYPE_FORWARD_ONLY、 ResultSet.TYPE_SCROLL_INSENSITIVE、 或 ResultSet.TYPE_SCROLL_SENSITIVE
- resultSetConcurrency
- Int32
以下常數之一 ResultSet ： ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE
- resultSetHoldability
- Int32
以下常數之一 ResultSet ： ResultSet.HOLD_CURSORS_OVER_COMMIT 或 ResultSet.CLOSE_CURSORS_AT_COMMIT
傳回
一個包含 PreparedStatement 預先編譯的 SQL 陳述式的新物件，將產生 ResultSet 具有指定類型、並行性及可hold性物件
- 屬性
例外狀況
如果存取資料庫時發生問題。
備註
建立 PreparedStatement 一個物件，能產生 ResultSet 具有特定類型、並行性及可hold性的物件。
此方法與上述方法相同 prepareStatement ，但允許覆蓋預設結果集類型、並行性及可保留性。
在 1.4 版本加入。
Java 文件 java.sql.Connection.prepareStatement(java.lang.String, int, int, int)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。