OdbcCommand Klasse

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Quelle:

OdbcCommand.cs

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die in einer Datenquelle ausgeführt werden soll. Diese Klasse kann nicht vererbt werden.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Vererbung

Object

DbCommand

OdbcCommand

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird ExecuteNonQuery verwendet.

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.
    }

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

Hinweise

Die OdbcCommand -Klasse stellt die folgenden 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 SQL INSERT-, DELETE-, UPDATE- und SET-Anweisungen aus.
ExecuteScalar	Ruft einen einzelnen Wert, z. B. einen Aggregatwert, aus einer Datenbank ab.

Sie können die CommandText Eigenschaft zurücksetzen und das Objekt wiederverwenden OdbcCommand . Sie müssen jedoch schließen OdbcDataReader , bevor Sie einen neuen oder vorherigen Befehl ausführen können.

Wenn die Ausführung des Befehls einen schwerwiegenden OdbcException Fehler verursacht, z. B. ein SQL Server Schweregrad von 20 oder mehr, OdbcConnection kann geschlossen werden. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Konstruktoren

OdbcCommand()	Initialisiert eine neue Instanz der OdbcCommand-Klasse.
OdbcCommand(String)	Initialisiert eine neue Instanz der OdbcCommand-Klasse mit dem Text der Abfrage.
OdbcCommand(String, OdbcConnection)	Initialisiert eine neue Instanz der OdbcCommand-Klasse mit dem Text der Abfrage und ein OdbcConnection-Objekt.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Initialisiert eine neue Instanz der OdbcCommand-Klasse mit dem Text der Abfrage, einem OdbcConnection-Objekt und der Transaction.

Eigenschaften

CommandText	Ruft eine SQL-Anweisung oder eine gespeicherte Prozedur zur Ausführung für die Datenquelle ab oder legt sie fest.
CommandTimeout	Ruft die Zeit (in Sekunden) ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.
CommandType	Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen Wert fest.
Connection	Ruft die OdbcConnection ab, die von dieser Instanz des OdbcCommand verwendet wird, oder legt diese fest.
DbConnection	Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest. (Geerbt von DbCommand)
DbParameterCollection	Ruft die Auflistung von DbParameter-Objekten ab. (Geerbt von DbCommand)
DbTransaction	Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest. (Geerbt von DbCommand)
DesignTimeVisible	Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Schnittstellensteuerelement sichtbar sein soll, oder legt diesen fest.
Parameters	Ruft das OdbcParameterCollection ab.
Transaction	Ruft die OdbcTransaction ab, in der der OdbcCommand ausgeführt wird, bzw. legt diese fest.
UpdatedRowSource	Ruft einen Wert ab, der angibt, wie die Update-Methode Befehlsergebnisse auf die DataRow anwendet, oder legt diesen fest.

Methoden

Cancel()	Versucht, die Ausführung eines OdbcCommand abzubrechen.
CreateDbParameter()	Erstellt eine neue Instanz eines DbParameter-Objekts. (Geerbt von DbCommand)
CreateParameter()	Erstellt eine neue Instanz eines OdbcParameter -Objekts.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DbCommand)
Dispose(Boolean)	Gibt die von DbCommand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbCommand)
DisposeAsync()	Stellt das Befehlsobjekt asynchron bereit. (Geerbt von DbCommand)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt einen zurück DbDataReader , der für den Zugriff auf die Ergebnisse verwendet werden kann. (Geerbt von DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen. Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren. (Geerbt von DbCommand)
ExecuteNonQuery()	Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteNonQueryAsync()	Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für sein Verbindungsobjekt ausführt und die Anzahl der betroffenen Zeilen zurückgibt. Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
ExecuteReader()	Sendet den CommandText an die Connection und erstellt einen OdbcDataReader.
ExecuteReader(CommandBehavior)	Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OdbcDataReader.
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CancellationToken)	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteScalar()	Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile in dem von der Abfrage zurückgegebenen Resultset zurück. Weitere Spalten oder Zeilen werden ignoriert.
ExecuteScalarAsync()	Eine asynchrone Version von ExecuteScalar(), die den Befehl ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert. Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteScalarAsync(CancellationToken)	Dies ist die asynchrone Version von ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Prepare()	Erstellt eine vorbereitete oder kompilierte Version des Befehls an der Datenquelle.
PrepareAsync(CancellationToken)	Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle. (Geerbt von DbCommand)
ResetCommandTimeout()	Setzt die CommandTimeout-Eigenschaft auf den Standardwert zurück.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter Clone().

Weitere Informationen

• OdbcDataAdapter
• OdbcConnection
• Ausführen eines Befehls