IDbCommand.Prepare-Methode

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Sub Prepare
'Usage
Dim instance As IDbCommand

instance.Prepare

void Prepare ()

void Prepare ()

void Prepare ()

function Prepare ()

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Connection wurde nicht festgelegt. – oder – Connection ist nicht Open.

Hinweise

Wenn die CommandType-Eigenschaft auf TableDirect festgelegt ist, führt Prepare keine Aktion aus. Wenn CommandType auf StoredProcedure festgelegt ist, kann der Aufruf von Prepare erfolgreich ausgeführt werden, auch wenn möglicherweise keine Aktion ausgeführt wird.

Beispiel

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse OleDbCommand erstellt und die Verbindung wird geöffnet. Anschließend wird eine gespeicherte Prozedur für die Datenquelle vorbereitet. Dazu wird eine Zeichenfolge übergeben, die eine SQL-Select-Anweisung ist, sowie eine Zeichenfolge zum Herstellen einer Verbindung mit der Datenquelle.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDbCommand-Schnittstelle
IDbCommand-Member
System.Data-Namespace