IDbCommand.Prepare Metodo

Definizione

Crea una versione preparata o compilata del comando nell'origine dati.

public void Prepare ();

Eccezioni

La proprietà Connection non è impostata.

-oppure-

Connection non è Open().

Esempio

Nell'esempio seguente viene creata un'istanza della classe derivata , OleDbCommande viene aperta la connessione. Nell'esempio viene quindi preparata una stored procedure nell'origine dati passando una stringa che è un'istruzione SQL Select e una stringa da usare per connettersi all'origine dati.

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

Commenti

Se la CommandType proprietà è impostata su TableDirect, Prepare non esegue alcuna operazione. Se CommandType è impostato su StoredProcedure, la chiamata a Prepare deve avere esito positivo, anche se può comportare un'assenza di operazioni. Il server memorizza automaticamente nella cache i piani per il riutilizzo in base alle esigenze; pertanto, non è necessario chiamare questo metodo direttamente nell'applicazione client.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1