DB2 V9.7 for Linux, UNIX, and Windows

DB2Command.Prepare 方法

在数据库中创建已准备（或已编译）版本的命令。

名称空间：: IBM.Data.DB2
组合件：: IBM.Data.DB2（在 IBM.Data.DB2.dll 中）

语法

[Visual Basic]
NotOverridable Public Sub Prepare()
[C#]
public void Prepare();
[C++]
public: __sealed void Prepare();
[JScript]
public function Prepare();

异常

异常类型	条件
InvalidOperationException	未设置 Connection。 -或者- Connection 不是 DB2Connection.Open。

异常类型

条件

InvalidOperationException

未设置 Connection。

-或者-

Connection 不是 DB2Connection.Open。

注释

调用 Prepare 前，请在要编译的语句中指定每个参数的数据类型。对于具有变长数据类型的每个参数，必须将 "DB2Parameter.Size 属性设置为所需的最大大小。如果不满足这些条件，那么 Prepare 将返回错误。

如果在调用 Prepare 后调用 Execute 方法，那么比 Size 属性所指定的值更大的任何参数值都将自动截断为该参数的原始指定大小，并且不返回截断错误。

输出参数（无论是否已准备）必须具有用户指定的数据类型。如果指定变长数据类型，那么还必须指定最大大小（Size）。

示例

[Visual Basic, C#] 以下示例通过传递字符串以连接至数据库来创建数据库连接、通过传递作为 SQL SELECT 语句和连接对象的字符串来创建 DB2Command 并打开该连接。然后，该示例在数据库上准备命令（先前已传递的 SQL SELECT 语句）。

[Visual Basic]
Public Sub CreateMyDB2Command(mySelectQuery As String, _
myConnectionString As String)
    Dim myConnection As New DB2Connection(myConnectionString)
    Dim myCommand As New DB2Command(mySelectQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.Prepare()
End Sub

[C#]
public void CreateMyDB2Command(string mySelectQuery, string myConnectionString)
{
   DB2Connection myConnection = new DB2Connection(myConnectionString);
   DB2Command myCommand = new DB2Command(mySelectQuery, myConnection);
   myCommand.Connection.Open();
   myCommand.Prepare();
}