OdbcCommand-Klasse

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die für eine Datenquelle ausgeführt werden soll. Die Klasse kann nicht geerbt werden.

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

Syntax

'Declaration
Public NotInheritable Class OdbcCommand
    Inherits DbCommand
    Implements ICloneable
'Usage
Dim instance As OdbcCommand

public sealed class OdbcCommand : DbCommand, ICloneable

public ref class OdbcCommand sealed : public DbCommand, ICloneable

public final class OdbcCommand extends DbCommand implements ICloneable

public final class OdbcCommand extends DbCommand implements ICloneable

Hinweise

Die OdbcCommand-Klasse stellt folgende Methoden zum Ausführen von Befehlen für eine Datenquelle bereit:

Element	Beschreibung
ExecuteReader	Führt Befehle aus, die Zeilen zurückgeben.
ExecuteNonQuery	Führt Befehle wie die SQL-Anweisungen INSERT, DELETE, UPDATE und SET aus.
ExecuteScalar	Ruft einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank ab.

Sie können die CommandText-Eigenschaft zurücksetzen und das OdbcCommand-Objekt wiederverwenden. Sie müssen jedoch den OdbcDataReader schließen, bevor ein neuer oder zuvor verwendeter Befehl ausgeführt werden kann.

Wenn die Ausführung des Befehls zu einer schwerwiegenden OdbcException führt (z. B. mit einem SQL Server-Schweregrad von 20 oder höher), kann die OdbcConnection geschlossen werden. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Beispiel

Im folgenden Beispiel wird die ExecuteReader -Methode der OdbcCommand-Klasse zusammen mit den OdbcDataReader-Klassen und den OdbcConnection-Klassen verwendet, um Zeilen aus einer Tabelle auszuwählen.

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection = 
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.Odbc.OdbcCommand

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

OdbcCommand-Member
System.Data.Odbc-Namespace
OdbcDataAdapter
OdbcConnection

Weitere Ressourcen

Executing a Command