SqlCommand.Prepare Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

Vytvoří připravenou verzi příkazu v instanci SQL Server.

public:
 override void Prepare();

public override void Prepare ();

override this.Prepare : unit -> unit

Public Overrides Sub Prepare ()

Příklady

Následující příklad ukazuje použití Prepare metody.

private static void SqlCommandPrepareEx(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        SqlCommand command = new SqlCommand(null, connection);

        // Create and prepare an SQL statement.
        command.CommandText =
            "INSERT INTO Region (RegionID, RegionDescription) " +
            "VALUES (@id, @desc)";
        SqlParameter idParam = new SqlParameter("@id", SqlDbType.Int, 0);
        SqlParameter descParam =
            new SqlParameter("@desc", SqlDbType.Text, 100);
        idParam.Value = 20;
        descParam.Value = "First Region";
        command.Parameters.Add(idParam);
        command.Parameters.Add(descParam);

        // Call Prepare after setting the Commandtext and Parameters.
        command.Prepare();
        command.ExecuteNonQuery();

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

Private Sub SqlCommandPrepareEx(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Dim command As New SqlCommand("", connection)

        ' Create and prepare an SQL statement.
        command.CommandText = _
           "INSERT INTO Region (RegionID, RegionDescription) " & _
           "VALUES (@id, @desc)"
        Dim idParam As SqlParameter = _
            New SqlParameter("@id", SqlDbType.Int, 0)
        Dim descParam As SqlParameter = _
            New SqlParameter("@desc", SqlDbType.Text, 100)
        idParam.Value = 20
        descParam.Value = "First Region"
        command.Parameters.Add(idParam)
        command.Parameters.Add(descParam)

        ' Call Prepare after setting the Commandtext and Parameters.
        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

Poznámky

Pokud CommandType je nastavená hodnota StoredProcedure, mělo by volání proběhnout Prepare úspěšně, i když to může způsobit no-op.

Před voláním Preparezadejte datový typ každého parametru v příkazu, který se má připravit. Pro každý parametr, který má datový typ proměnné délky, musíte vlastnost nastavit Size na maximální požadovanou velikost. Prepare vrátí chybu, pokud tyto podmínky nejsou splněny.

Poznámka

Pokud se kontext databáze změní spuštěním příkazu Transact-SQL USE <database> nebo voláním ChangeDatabase metody, Prepare musí být volána podruhé.

Pokud zavoláte metodu Execute po volání Prepare, jakákoli hodnota parametru, která je větší než hodnota určená Size vlastností, se automaticky zkrátí na původní zadanou velikost parametru a nevrátí se žádné chyby zkrácení.

Výstupní parametry (ať už jsou připravené nebo ne) musí mít datový typ zadaný uživatelem. Pokud zadáte datový typ proměnné délky, musíte také zadat maximální Sizehodnotu .

Před verzí Visual Studio 2010 došlo Prepare k výjimce. Počínaje sadou Visual Studio 2010 tato metoda nevyvolá výjimku.

Viz také

• Připojení a načítání dat v ADO.NET
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET