OdbcCommand.Prepare メソッド

.NET Framework クラス ライブラリ リファレンス

OdbcCommand.Prepare メソッド

データ ソースに対する準備済みの (コンパイルされた) コマンドを作成します。

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Prepare

Visual Basic (使用法)

Dim instance As OdbcCommand

instance.Prepare

C#

public override void Prepare ()

C++

public:
virtual void Prepare () override

J#

public void Prepare ()

JScript

public override function Prepare ()

例外

例外の種類	条件
InvalidOperationException	Connection が設定されていません。 または Connection が .Data.Odbc.OdbcConnection.Open ではありません。

解説

Prepare メソッドは、ODBC の SQLPrepare 関数を呼び出します。基になる ODBC ドライバとデータ ソースの機能によって、ステートメントの準備時 (すべてのパラメータがバインドされている場合) または実行時 (すべてのパラメータがバインドされていない場合) に、パラメータ情報 (データ型など) を確認できます。高い相互運用性を実現するために、アプリケーションで同じ OdbcCommand に対して新しい SQL ステートメントを準備する前に、その前に実行した SQL ステートメントに適用したすべてのパラメータのバインドを解除する必要があります。これにより、以前に使用されたパラメータ情報が新しい SQL ステートメントに適用されるために発生するエラーを防ぐことができます。

Prepare を呼び出した後で Execute メソッドを呼び出すと、.Data.Odbc.OdbcParameter.Size プロパティに指定した値よりも大きいパラメータ値は、パラメータで指定したサイズに自動的に切り詰められます。このとき、切り捨てエラーは返されません。

出力パラメータは、準備済みかどうかにかかわらず、ユーザー指定のデータ型にする必要があります。可変長データ型を指定する場合は、.Data.Odbc.OdbcParameter.Size の最大値も指定する必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OdbcCommand クラス
OdbcCommand メンバ
System.Data.Odbc 名前空間
その他の技術情報
Executing a Command