SqlCommand.Prepare SqlCommand.Prepare SqlCommand.Prepare SqlCommand.Prepare Method

Definition

Erstellt eine vorbereitete Version des Befehls in einer Instanz von SQL Server.Creates a prepared version of the command on an instance of SQL Server.

public:
 override void Prepare();
public override void Prepare ();
override this.Prepare : unit -> unit
Public Overrides Sub Prepare ()

Implementiert

Beispiele

Im folgenden Beispiel wird die Verwendung der Prepare-Methode gezeigt.The following example demonstrates the use of the Prepare method.

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 SqlCommand = 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

Hinweise

Wenn CommandType nastaven NA hodnotu StoredProcedure, den Aufruf von Prepare sollte erfolgreich sein, obwohl sie keine Aktion führen kann.If CommandType is set to StoredProcedure, the call to Prepare should succeed, although it may cause a no-op.

Vor dem Aufruf Prepare, geben Sie den Datentyp jedes Parameters in der Anweisung vorbereitet werden.Before you call Prepare, specify the data type of each parameter in the statement to be prepared. Für jeden Parameter, der einen Datentyp variabler Länge aufweist, müssen Sie festlegen der Size Eigenschaft, um die maximale Größe, die erforderlich sind.For each parameter that has a variable length data type, you must set the Size property to the maximum size needed. Prepare Gibt einen Fehler zurück, wenn diese Bedingungen nicht erfüllt sind.Prepare returns an error if these conditions are not met.

Hinweis

Wenn der Kontext der Datenbank geändert wird, indem Sie Ausführung der Transact-SQL USE <database> -Anweisung oder durch Aufrufen der ChangeDatabase -Methode, klicken Sie dann Prepare muss ein zweites Mal aufgerufen werden.If the database context is changed by executing the Transact-SQL USE <database> statement, or by calling the ChangeDatabase method, then Prepare must be called a second time.

Aufrufen einer Execute Methode nach dem Aufruf Prepare, jeder Parameterwert, der größer als der angegebene Wert ist die Size Eigenschaft wird automatisch abgeschnitten, um die ursprünglich angegebene Größe des Parameters und kein Kürzungsfehler sind zurückgegeben.If you call an Execute method after calling Prepare, any parameter value that is larger than the value specified by the Size property is automatically truncated to the original specified size of the parameter, and no truncation errors are returned.

Ausgabeparameter (ob oder nicht vorbereitet werden soll) muss einen benutzerdefinierten Datentyp aufweisen.Output parameters (whether prepared or not) must have a user-specified data type. Wenn Sie einen Datentyp variabler Länge angeben, müssen Sie auch angeben, auf die maximale Size.If you specify a variable length data type, you must also specify the maximum Size.

Vor Visual Studio 2010 Prepare hat eine Ausnahme ausgelöst.Prior to Visual Studio 2010, Prepare threw an exception. Ab Visual Studio 2010, löst diese Methode keine Ausnahme aus.Beginning in Visual Studio 2010, this method does not throw an exception.

Gilt für:

Siehe auch