IDbCommand.Prepare Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Membuat versi perintah yang disiapkan (atau dikompilasi) pada sumber data.

public:
 void Prepare();

public void Prepare ();

abstract member Prepare : unit -> unit

Public Sub Prepare ()

Pengecualian

InvalidOperationException

Connection belum disetel.

-atau-

Connection bukan Open().

Contoh

Contoh berikut membuat instans kelas turunan, OleDbCommand, dan membuka koneksi. Contoh kemudian menyiapkan prosedur tersimpan pada sumber data dengan meneruskan string yang merupakan pernyataan SQL Select dan string yang akan digunakan untuk menyambungkan ke sumber data.

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();
    }
}

Public Sub OleDbCommandPrepare(ByVal connectionString As String)

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

        ' Create the Command.
        Dim command As 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

Keterangan

CommandType Jika properti diatur ke TableDirect, Prepare tidak melakukan apa pun. Jika CommandType diatur ke StoredProcedure, panggilan ke Prepare harus berhasil, meskipun dapat mengakibatkan no-op. Server secara otomatis menyimpan rencana untuk digunakan kembali seperlunya; oleh karena itu, tidak perlu memanggil metode ini langsung di aplikasi klien Anda.