文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.2Kb
Man Pages (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 參考手冊  /  ...  /  PreparedStatement 物件

27.3.6.7 PreparedStatement 物件

PreparedStatement 物件代表執行預先處理陳述式的處理常式。它支援下列方法

  • bind(Value data):註冊一個或多個值清單,以便在執行 SQL 陳述式時繫結。參數會依列出的順序繫結,並且是類型特定的;請參閱第 27.3.4 節「JavaScript 儲存程式資料類型和引數處理」,取得支援的資料類型清單。

    在預先處理陳述式首次執行之前,其所有參數都必須繫結至值;若未繫結,當嘗試呼叫PreparedStatement.execute()時會引發錯誤。後續執行預先處理陳述式時,可以使用比陳述式中參數標記更少的繫結參數;在這種情況下,遺失的參數會保留先前執行中的值。

    嘗試繫結比參數標記更多的參數,或繫結至類型不正確的參數,會遭到拒絕並顯示錯誤。在此預先處理陳述式呼叫deallocate()之後,再呼叫此方法也會引發錯誤。

    傳回它所呼叫的相同 PreparedStatement 物件的參考。

  • deallocate():關閉預先處理陳述式並釋放相關資源。在此之後,不應進行 PreparedStatementSqlResult 方法呼叫。

    呼叫此方法相當於在 mysql 用戶端中執行 DEALLOCATE PREPARE 陳述式。

  • execute():執行預先處理的查詢,並傳回對應的 SqlResult

    呼叫此方法相當於在 mysql 用戶端中執行 EXECUTE 陳述式。

  • getOption(String optionName):取得此陳述式中 optionName 選項的值。僅支援 passResultToClientcharsetName 值。

如需其他資訊和範例,請參閱第 27.3.7.2 節「預先處理陳述式」