DB2CommandBuilder.DeriveParameters 方法

從儲存程序或 DB2Command 中指定的指令文字擷取參數資訊,並移入指定 DB2Command 物件的 Parameters 集合。

名稱空間:
IBM.Data.DB2
組件:
IBM.Data.DB2 (在 IBM.Data.DB2.dll中)

語法

commandcommandcommandcommand
[Visual Basic]
Public Shared Sub DeriveParameters( _
   ByVal  As DB2Command
 _
)
[C#]
public static void DeriveParameters(
   DB2Command
 
);
[C++]
public: static void DeriveParameters(
   DB2Command
* 
);
[JScript]
public static function DeriveParameters(
    : DB2Command

);

參數

command
DB2®指令 參照儲存程序,或要從中衍生參數資訊的指令文字 。 衍生參數會新增至 DB2CommandDB2Command.Parameters 集合。

異常狀況

異常狀況類型 條件
引數異常狀況  
InvalidOperationException 在下列條件下會擲出 InvalidOperationException :
  • 驅動程式不支援傳回儲存程序參數資訊。
  • TableDirect 指定給 System.Data.CommandType
  • 如果指定 StoredProcedureSystem.Data.CommandType ,但 System.Data.CommandText 包含無效的儲存程序名稱。
  • 當呼叫 DB2CommandBuilder.DeriveParameters 方法時,如果連線不存在或連線未開啟。
.

備註

DeriveParameters 會改寫 DB2Command的任何現有參數資訊。

CommandType 設為 CommandType.StoredProcedureCommandType.Text時,您可以使用 DeriveParameters 。 如果指定 CommandType.StoredProcedure ,則 CommandText 必須包含有效的儲存程序名稱。 如果指定 CommandType.Text ,則 CommandText 必須包含 SQL 陳述式或具有有效參數的儲存程序呼叫陳述式。

不建議在超載儲存程序上使用 DeriveParameters ,因為會傳回所有合格程序的所有參數。

依預設, DeriveParameters 會將 ReturnValue 參數新增至 DB2CommandParameters 集合。

DeriveParameters 需要額外呼叫資料伺服器來取得資訊。 如果事先知道參數資訊,則透過明確設定資訊來移入參數集合會更有效率。