共用方式為


設定參數值

若要設定參數的值,應用程式只會設定繫結至參數的變數值。 設定此值的時機並不重要,只要在執行陳述式之前設定即可。 應用程式可以在繫結變數之前或之後設定值,而且可以視需要多次變更值。 執行陳述式時,驅動程式只會擷取變數的目前值。 當備妥的陳述式執行多次時,這特別有用;應用程式會在每次執行陳述式時,設定部分或所有變數的新值。 如需此範例,請參閱本節稍早的備妥的執行

如果長度/指標緩衝區已在對 SQLBindParameter 的呼叫中,則必須先設定為下列其中一個值,才能執行陳述式:

  • 繫結變數中資料的位元組長度。 只有在變數是字元或二進位 (ValueType 為 SQL_C_CHAR 或 SQL_C_BINARY) 時,驅動程式才會檢查此長度。

  • SQL_NTS。 資料是以 Null 結尾的字串。

  • SQL_NULL_DATA。 資料值為 Null,而驅動程式會忽略繫結變數的值。

  • SQL_DATA_AT_EXEC 或 SQL_LEN_DATA_AT_EXEC 巨集的結果。 參數的值是使用 SQLPutData 傳送。 如需詳細資訊,請參閱本節稍後討論的傳送長資料

下表顯示繫結變數的值,以及應用程式針對各種參數值所設定的長度/指標緩衝區。

參數

value
參數

(SQL)

資料類型
變數 (C)

資料類型
中的值

繫結

變動
中的值

長度/指標

緩衝區[d]
"ABC" SQL_CHAR SQL_C_CHAR ABC\0[a] SQL_NTS 或 3
10 SQL_INTEGER SQL_C_SLONG 10 --
10 SQL_INTEGER SQL_C_CHAR 10\0[a] SQL_NTS 或 2
1 P.M. SQL_TYPE_TIME SQL_C_TYPE_TIME 13,0,0[b] --
1 P.M. SQL_TYPE_TIME SQL_C_CHAR {t '13:00:00'}\0[a], [c] SQL_NTS 或 14
NULL SQL_SMALLINT SQL_C_SSHORT -- SQL_NULL_DATA

[a] "\0" 代表 Null 終止字元。 只有在長度/指標緩衝區中的值為 SQL_NTS 時,才需要 Null 終止字元。

[b] 此清單中的數值是儲存在 TIME_STRUCT 結構的欄位中數值。

[c] 字串會使用 ODBC 日期逸出子句。 如需詳細資訊,請參閱日期、時間和時間戳記常值

[d] 驅動程式必須一律檢查此值,以查看該值是否為特殊值,例如 SQL_Null_DATA。

驅動程式在執行階段使用參數值的功能與驅動程式相依。 如有必要,驅動程式會將繫結變數的 C 資料類型和位元組長度值轉換為參數 SQL 資料類型、有效位數和小數位數。 在大部分情況下,驅動程式接著會將值傳送至資料來源。 在某些情況下,驅動程式會將值格式化為文字,並將該文字插入 SQL 陳述式,再將陳述式傳送至資料來源。