OdbcCommand.Prepare メソッド
メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
データ ソースに対する準備済みの (コンパイルされた) コマンドを作成します。
Public Overridable Sub Prepare() Implements IDbCommand.Prepare
[C#]
public virtual void Prepare();
[C++]
public: virtual void Prepare();
[JScript]
public function Prepare();
実装
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | Connection が設定されていません。
または Connection が Open ではありません。 |
解説
Prepare メソッドは、ODBC の SQLPrepare 関数を呼び出します。基になる ODBC ドライバとデータ ソースの機能によって、ステートメントの準備時 (すべてのパラメータがバインドされている場合) または実行時 (すべてのパラメータがバインドされていない場合) に、パラメータ情報 (データ型など) を確認できます。高い相互運用性を実現するために、アプリケーションで同じ OdbcCommand に対して新しい SQL ステートメントを準備する前に、その前に実行した SQL ステートメントに適用したすべてのパラメータのバインドを解除する必要があります。これにより、以前に使用されたパラメータ情報が新しい SQL ステートメントに適用されるために発生するエラーを防ぐことができます。
Prepare を呼び出した後で Execute メソッドを呼び出すと、 Size プロパティに指定した値よりも大きいパラメータ値は、パラメータで指定したサイズに自動的に切り詰められます。このとき、切り捨てエラーは返されません。
出力パラメータは、準備済みかどうかにかかわらず、ユーザー指定のデータ型にする必要があります。可変長データ型を指定する場合は、 Size の最大値も指定する必要があります。
使用例
[Visual Basic, C#, C++] OdbcCommand を作成し、接続を開く例を次に示します。この例では、続いて、SQL SELECT ステートメントの文字列とデータ ソースへの接続に使用する文字列を渡して、データ ソースに対するストアド プロシージャを準備します。
Public Sub CreateMyOdbcCommand(mySelectQuery As String, _
myConnectionString As String)
Dim myConnection As New OdbcConnection(myConnectionString)
Dim myCommand As New OdbcCommand(mySelectQuery, myConnection)
myCommand.Connection.Open()
myCommand.Prepare()
End Sub
[C#]
public void CreateMyOdbcCommand(string mySelectQuery, string myConnectionString)
{
OdbcConnection myConnection = new OdbcConnection(myConnectionString);
OdbcCommand myCommand = new OdbcCommand(mySelectQuery, myConnection);
myCommand.Connection.Open();
myCommand.Prepare();
}
[C++]
public:
void CreateMyOdbcCommand(String* mySelectQuery, String* myConnectionString)
{
OdbcConnection* myConnection = new OdbcConnection(myConnectionString);
OdbcCommand* myCommand = new OdbcCommand(mySelectQuery, myConnection);
myCommand->Connection->Open();
myCommand->Prepare();
};
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ