描述項的類型

描述項是用來描述下列其中一項：

• 一組零個或多個參數。 參數描述項可用來描述：

  • 應用程式參數緩衝區，其中包含應用程式所設定的輸入動態引數，或執行 SQL 的 CALL陳述式之後的輸出動態引數。

  • 實作參數緩衝區。 在應用程式可能指定的任何資料轉換之後，輸入動態引數會包含與應用程式參數緩衝區相同的引數。 在應用程式可能指定的任何資料轉換之後，輸出動態引數會包含傳回的引數。

  對於輸入動態引數，應用程式必須在應用程式參數描述項上運作，才能執行包含動態參數標記的任何 SQL 陳述式。 針對輸入和輸出動態引數，應用程式可以從實作參數描述項中的資料類型指定不同的資料類型，以達成資料轉換。

• 單一資料庫資料列。 資料列描述項可用來描述：

  • 實作資料列緩衝區，其中包含資料庫中的資料列。 (這些緩衝區在概念上包含寫入或讀取資料庫的資料。不過，未指定儲存資料庫資料的儲存形式。資料庫可以在實作緩衝區中對資料執行其他形式轉換。)

  • 應用程式資料列緩衝區，其中包含提供給應用程式的資料列，以及應用程式可能指定的任何資料轉換。

  來自資料庫的資料行資料必須出現在應用程式變數中的任何情況下，應用程式會在應用程式資料列描述項上運作。 若要實現資料行資料的資料轉換，應用程式可以從實作資料列描述項中的資料類型指定不同的資料類型。

下表摘要說明描述項類型。

緩衝區類型	資料列	動態參數
應用程式緩衝區	應用程式資料列描述項 (ARD)	應用程式參數描述項 (APD)
實作緩衝區	實作資料列描述項 (IRD)	實作參數描述項 (IPD)

針對參數或資料列緩衝區，如果應用程式在實作和應用程式描述項的對應記錄中指定不同的資料類型，驅動程式會在使用描述項時執行資料轉換。 例如，可能會將數值和日期時間值轉換成字元字串格式。 (如需有效轉換的資訊，請參閱附錄 D：資料類型。)

描述項可以執行不同的角色。 不同的陳述式可以共用應用程式明確配置的任何描述項。 一個陳述式中的資料列描述項可作為其他陳述式中的參數描述項。

即使尚未在資料庫作業中使用描述項，一律可以知道是指定描述項還是實作描述項。 針對實作隱含配置的描述項，實作會記錄相對於陳述式控制代碼的預先定義資料列。 應用程式透過呼叫 SQLAllocHandle 所配置的任何描述項皆為應用程式描述項。