OdbcCommand Klasse

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.1.24431.7

Quelle:

OdbcCommand.cs

Stellt eine SQL-Anweisung oder gespeicherte Prozedur dar, die für eine Datenquelle ausgeführt werden soll. Diese Klasse kann nicht geerbt 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

MarshalByRefObject

Component

DbCommand

OdbcCommand

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird ExecuteNonQueryverwendet.

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:

Artikel	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 OdbcCommand-Objekt wiederverwenden. Sie müssen die OdbcDataReader jedoch schließen, bevor Sie einen neuen oder vorherigen Befehl ausführen können.

Wenn die Ausführung des Befehls zu einem schwerwiegenden OdbcException führt, z. B. eine SQL Server-Schweregrad von 20 oder mehr, kann OdbcConnection geschlossen werden. Der Benutzer kann die Verbindung jedoch 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 einem 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

CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
CommandText	Dient zum Abrufen oder Festlegen der SQL-Anweisung oder gespeicherten Prozedur, die für die Datenquelle ausgeführt werden soll.
CommandTimeout	Ruft die Wartezeit (in Sekunden) ab, bevor ein Versuch zum Ausführen eines Befehls beendet und ein Fehler generiert wird, oder legt diese fest.
CommandType	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie die CommandText -Eigenschaft interpretiert wird.
Connection	Dient zum Abrufen oder Festlegen der OdbcConnection, die von dieser Instanz des OdbcCommandverwendet wird.
Container	Ruft die IContainer ab, die den Componententhält. (Geerbt von Component)
DbConnection	Dient zum Abrufen oder Festlegen der von diesem DbCommandverwendeten DbConnection. (Geerbt von DbCommand)
DbParameterCollection	Ruft die Auflistung von DbParameter -Objekten ab. (Geerbt von DbCommand)
DbTransaction	Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird. (Geerbt von DbCommand)
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet. (Geerbt von Component)
DesignTimeVisible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Befehlsobjekt in einem angepassten Schnittstellensteuerelement sichtbar sein soll.
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component)
Parameters	Ruft die OdbcParameterCollectionab.
Site	Dient zum Abrufen oder Festlegen des ISite des Component. (Geerbt von Component)
Transaction	Dient zum Abrufen oder Festlegen des OdbcTransaction, in dem die OdbcCommand ausgeführt wird.
UpdatedRowSource	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie die Update -Methode Befehlsergebnisse auf die DataRow-anwenden soll.

Methoden

Cancel()	Versucht, die Ausführung eines OdbcCommandabzubrechen.
CreateDbParameter()	Erstellt eine neue Instanz eines DbParameter-Objekts. (Geerbt von DbCommand)
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
CreateParameter()	Erstellt eine neue Instanz eines OdbcParameter-Objekts.
Dispose()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von DbCommand)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom DbCommand verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von DbCommand)
DisposeAsync()	Das Befehlsobjekt wird asynchron eingetaucht. (Geerbt von DbCommand)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt eine DbDataReader zurück, die 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, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Diese Methode akzeptiert ein Abbruchtoken, mit dem der Vorgang frühzeitig abgebrochen werden kann. Implementierungen können diese Anforderung ignorieren. (Geerbt von DbCommand)
ExecuteNonQuery()	Führt eine SQL-Anweisung für das Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteNonQueryAsync()	Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für das 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 geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
ExecuteReader()	Sendet die CommandText an die Connection und erstellt eine OdbcDataReader.
ExecuteReader(CommandBehavior)	Sendet den CommandText an den Connectionund erstellt eine OdbcDataReader mit einem der CommandBehavior Werte.
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader, die den Befehl für die 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 die 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 die 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 im Resultset zurück, die von der Abfrage zurückgegeben wird. Zusätzliche 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 geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteScalar ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
Prepare()	Erstellt eine vorbereitete oder kompilierte Version des Befehls in der Datenquelle.
PrepareAsync(CancellationToken)	Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls in der Datenquelle. (Geerbt von DbCommand)
ResetCommandTimeout()	Setzt die eigenschaft CommandTimeout auf den Standardwert zurück.
ToString()	Gibt einen String zurück, der den Namen der Componententhält, falls vorhanden. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() -Methode verworfen wird. (Geerbt von Component)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Eine Beschreibung dieses Mitglieds finden Sie unter Clone().
IDbCommand.Connection	Dient zum Abrufen oder Festlegen der IDbConnection, die von dieser Instanz des IDbCommandverwendet wird. (Geerbt von DbCommand)
IDbCommand.CreateParameter()	Erstellt eine neue Instanz eines IDbDataParameter-Objekts. (Geerbt von DbCommand)
IDbCommand.ExecuteReader()	Führt die CommandText für die Connection aus und erstellt eine IDataReader. (Geerbt von DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Führt den CommandText für den Connectionaus und erstellt eine IDataReader unter Verwendung eines der CommandBehavior Werte. (Geerbt von DbCommand)
IDbCommand.Parameters	Ruft die IDataParameterCollectionab. (Geerbt von DbCommand)
IDbCommand.Transaction	Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird. (Geerbt von DbCommand)

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Weitere Informationen

• OdbcDataAdapter
• OdbcConnection
• Ausführen eines Befehls