IConnection.PrepareStatement 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
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 參數佔位元
傳回
包含預先編譯 SQL 語句的新預設 PreparedStatement
物件
- 屬性
例外狀況
如果存取資料庫時發生問題,則為 。
備註
PreparedStatement
建立物件,以便將參數化 SQL 語句傳送至資料庫。
具有或不含 IN 參數的 SQL 語句可以預先編譯並儲存在物件中 PreparedStatement
。 然後,這個物件可以用來有效率地執行這個語句多次。
<B>注意:</B> 這個方法已針對處理受益於先行編譯的參數 SQL 語句進行優化。 如果驅動程式支援先行編譯,方法 prepareStatement
會將 語句傳送至資料庫以進行先行編譯。 某些驅動程式可能不支援先行編譯。 在此情況下,在物件執行之前 PreparedStatement
,語句可能不會傳送至資料庫。 這對用戶沒有直接影響;不過,它確實會影響哪些方法會擲回特定 SQLException
物件。
使用傳 PreparedStatement
回物件建立的結果集預設會是型 TYPE_FORWARD_ONLY
別,且具有的並行層級 CONCUR_READ_ONLY
。 建立的結果集保留性可以藉由呼叫 #getHoldability
來決定。
的 java.sql.Connection.prepareStatement(java.lang.String)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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_KEYS
一個 Statement.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.sql.Connection.prepareStatement(java.lang.String, int)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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.sql.Connection.prepareStatement(java.lang.String, int[])
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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.sql.Connection.prepareStatement(java.lang.String, java.lang.String[])
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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 語句;可能包含一或多個 '?'IN 參數
- resultSetType
- Int32
結果集類型;、、 或 的ResultSet.TYPE_FORWARD_ONLY
ResultSet.TYPE_SCROLL_INSENSITIVE
其中一個ResultSet.TYPE_SCROLL_SENSITIVE
- resultSetConcurrency
- Int32
並行類型;或的其中 ResultSet.CONCUR_READ_ONLY
一個 ResultSet.CONCUR_UPDATABLE
傳回
新的 PreparedStatement 物件,其中包含預先編譯的 SQL 語句,將產生 ResultSet
具有指定類型和並行的物件
- 屬性
例外狀況
如果存取資料庫發生問題,則為 。
備註
PreparedStatement
建立物件,以產生ResultSet
具有指定型別和並行的物件。 這個方法與 prepareStatement
上述方法相同,但它允許覆寫默認結果集類型和並行。 建立的結果集保留性可以藉由呼叫 #getHoldability
來決定。
已在1.2中新增。
的 java.sql.Connection.prepareStatement(java.lang.String, int, int)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
PrepareStatement(String, Int32, Int32, Int32)
PreparedStatement
建立物件,以產生ResultSet
具有指定型別、並行和保留性的物件。
[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 語句;可能包含一或多個 '?'IN 參數
- 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
具有指定型別、並行和保留性的物件
- 屬性
例外狀況
如果存取資料庫發生問題,則為 。
備註
PreparedStatement
建立物件,以產生ResultSet
具有指定型別、並行和保留性的物件。
這個方法與 prepareStatement
上述方法相同,但它允許覆寫默認結果集類型、並行和保留性。
已在1.4中新增。
的 java.sql.Connection.prepareStatement(java.lang.String, int, int, int)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。