IDbCommand.Prepare メソッド

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

IDbCommand.Prepare メソッド

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

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

Visual Basic (宣言)

Sub Prepare

Visual Basic (使用法)

Dim instance As IDbCommand

instance.Prepare

C#

void Prepare ()

C++

void Prepare ()

J#

void Prepare ()

JScript

function Prepare ()

例外

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

解説

CommandType プロパティを TableDirect に設定したときは、Prepare では何も実行されません。CommandType を StoredProcedure に設定したときは、Prepare の呼び出しには成功しますが、結果が no-op になることがあります。

使用例

派生クラス OleDbCommand のインスタンスを作成し、接続を開く例を次に示します。この例では、次に、SQL Select ステートメントである文字列と、データ ソースに接続するために使用する文字列を渡して、データ ソースでストアド プロシージャを準備します。

Visual Basic

Public Sub OleDbCommandPrepare(ByVal
 connectionString As String)

    Using connection As OleDbConnection = New
 _
        OleDbConnection(connectionString)
        connection.Open()

        ' Create the Command.
        Dim command As OleDbCommand = New
 OleDbCommand()

        ' Set the Connection, CommandText and Parameters.
        command.Connection = connection
        command.CommandText = _
          "INSERT INTO dbo.Region (RegionID, RegionDescription)
 VALUES (?, ?);"
        command.Parameters.Add("RegionID", OleDbType.Integer,
 4)
        command.Parameters.Add("RegionDescription",
 OleDbType.VarWChar, 50)
        command.Parameters(0).Value = 20
        command.Parameters(1).Value = "First Region"

        ' Call  Prepare and ExecuteNonQuery.
        command.Prepare()
        command.ExecuteNonQuery()

        ' Change parameter values and call ExecuteNonQuery.
        command.Parameters(0).Value = 21
        command.Parameters(1).Value = "Second Region"
        command.ExecuteNonQuery()
    End Using
End Sub

C#

private static void OleDbCommandPrepare(string
 connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();

        // Create the Command.
        OleDbCommand command = new OleDbCommand();

        // Set the Connection, CommandText and Parameters.
        command.Connection = connection;
        command.CommandText =
            "INSERT INTO dbo.Region (RegionID, RegionDescription) VALUES (?,
 ?)";
        command.Parameters.Add("RegionID", OleDbType.Integer, 4);
        command.Parameters.Add("RegionDescription", OleDbType.VarWChar,
 50);
        command.Parameters[0].Value = 20;
        command.Parameters[1].Value = "First Region";

        // Call  Prepare and ExecuteNonQuery.
        command.Prepare();
        command.ExecuteNonQuery();

        // Change parameter values and call ExecuteNonQuery.
        command.Parameters[0].Value = 21;
        command.Parameters[1].Value = "SecondRegion";
        command.ExecuteNonQuery();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IDbCommand インターフェイス
IDbCommand メンバ
System.Data 名前空間