Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

OdbcCommand-Klasse

 

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

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

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

public sealed class OdbcCommand : DbCommand, ICloneable

NameBeschreibung
System_CAPS_pubmethodOdbcCommand()

Initialisiert eine neue Instanz der OdbcCommand-Klasse.

System_CAPS_pubmethodOdbcCommand(String)

Initialisiert eine neue Instanz der OdbcCommand-Klasse mit dem Text der Abfrage.

System_CAPS_pubmethodOdbcCommand(String, OdbcConnection)

Initialisiert eine neue Instanz von der OdbcCommand -Klasse mit dem Text der Abfrage und ein OdbcConnection Objekt.

System_CAPS_pubmethodOdbcCommand(String, OdbcConnection, OdbcTransaction)

Initialisiert eine neue Instanz der der OdbcCommand -Klasse mit dem Text der Abfrage und ein OdbcConnection -Objekt, und die Transaction.

NameBeschreibung
System_CAPS_pubpropertyCommandText

Ruft ab oder legt sie fest, die SQL-Anweisung oder gespeicherte Prozedur, die für die Datenquelle ausgeführt.(Überschreibt DbCommand.CommandText.)

System_CAPS_pubpropertyCommandTimeout

Ruft ab oder legt die Wartezeit, bevor ein Versuch zum Ausführen eines Befehls beendet und ein Fehler generiert.(Überschreibt DbCommand.CommandTimeout.)

System_CAPS_pubpropertyCommandType

Ruft ab oder legt einen Wert an der CommandText -Eigenschaft interpretiert wird.(Überschreibt DbCommand.CommandType.)

System_CAPS_pubpropertyConnection

Ruft ab oder legt die OdbcConnection verwendet, die durch diese Instanz von der OdbcCommand.

System_CAPS_pubpropertyContainer

Ruft die IContainer enthält die Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyDesignTimeVisible

Ruft ab oder legt einen Wert, der angibt, ob das Befehlsobjekt in einem Steuerelement benutzerdefinierte Schnittstelle sichtbar sein soll.(Überschreibt DbCommand.DesignTimeVisible.)

System_CAPS_pubpropertyParameters
System_CAPS_pubpropertySite

Ruft ab oder legt die ISite von der Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyTransaction

Ruft die OdbcTransaction ab, in der der OdbcCommand ausgeführt wird, bzw. legt diese fest.

System_CAPS_pubpropertyUpdatedRowSource

Ruft ab oder legt einen Wert, der angibt, wie die Update -Methode Befehlsergebnisse auf die DataRow.(Überschreibt DbCommand.UpdatedRowSource.)

NameBeschreibung
System_CAPS_pubmethodCancel()

Versucht, das Abbrechen der Ausführungsstatus einer OdbcCommand.(Überschreibt DbCommand.Cancel().)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodCreateParameter()

Erstellt eine neue Instanz von einem OdbcParameter Objekt.

System_CAPS_pubmethodDispose()

Gibt alle vom Component verwendeten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodExecuteNonQuery()

Führt eine SQL­Anweisung für die Connection und gibt die Anzahl der betroffenen Zeilen zurück.(Überschreibt DbCommand.ExecuteNonQuery().)

System_CAPS_pubmethodExecuteNonQueryAsync()

Eine asynchrone Version der ExecuteNonQuery, das ausgeführt wird, einer SQL-Anweisung für ein Connection-Objekt.

Ruft ExecuteNonQueryAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version der ExecuteNonQuery. Anbieter sollten durch eine geeignete Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone ExecuteNonQuery Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen Abbruchtoken übergeben. Ausgelöste Ausnahmen ExecuteNonQuery Updates werden über die zurückgegebene Ausnahme einer Aufgabe-Eigenschaft.

Andere Methoden und Eigenschaften nicht Aufrufen der DbCommand Objekt, bis die zurückgegebene Aufgabe abgeschlossen ist.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReader()

Sendet die CommandText an der Connection und erstellt eine OdbcDataReader.

System_CAPS_pubmethodExecuteReader(CommandBehavior)

Sendet die CommandText an der Connection, und erstellt ein OdbcDataReader mit einer der der CommandBehavior Werte.

System_CAPS_pubmethodExecuteReaderAsync()

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader.

Ruft ExecuteDbDataReaderAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CancellationToken)

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader. Diese Methode gibt eine Benachrichtigung, dass Vorgänge abgebrochen werden sollen.

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version der ExecuteReader, das ausgeführt wird, die CommandText für die Connection und gibt eine DbDataReader.

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.(Überschreibt DbCommand.ExecuteScalar().)

System_CAPS_pubmethodExecuteScalarAsync()

Eine asynchrone Version der ExecuteScalar, dem führt die Abfrage aus und gibt die erste Spalte der ersten Zeile in der von der Abfrage zurückgegebenen Resultset zurück. Alle anderen Spalten und Zeilen werden ignoriert.

Ruft ExecuteScalarAsync mit CancellationToken.None.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version der ExecuteScalar. Anbieter sollten durch eine geeignete Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone ExecuteScalar Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen Abbruchtoken übergeben. ExecuteScalar ausgelöste Ausnahmen werden über die zurückgegebene Ausnahme einer Aufgabe Eigenschaft mitgeteilt.

Andere Methoden und Eigenschaften nicht Aufrufen der DbCommand Objekt, bis die zurückgegebene Aufgabe abgeschlossen ist.(Geerbt von „DbCommand“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft die aktuellen Service-Objekt, das die Lebensdauerrichtlinien für diese Instanz steuert.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinien für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodPrepare()

Erstellt eine vorbereitete oder kompilierte Version des Befehls an der Datenquelle.(Überschreibt DbCommand.Prepare().)

System_CAPS_pubmethodResetCommandTimeout()

Setzt die CommandTimeout Eigenschaft auf den Standardwert.

System_CAPS_pubmethodToString()

Gibt eine String mit dem Namen der Component, sofern vorhanden. Diese Methode darf nicht überschrieben werden.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_pubeventDisposed

Tritt auf, wenn die Komponente, durch einen Aufruf freigegeben wird der Dispose Methode.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.CreateParameter()

Erstellt eine neue Instanz von einem IDbDataParameter Objekt.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader()

Führt die CommandText anhand der Connection und erstellt eine IDataReader.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader(CommandBehavior)

Führt die CommandText für die Connection, und erstellt ein IDataReader mithilfe eines der der CommandBehavior Werte.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Eine Beschreibung dieses Elements finden Sie unter ICloneable.Clone.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Connection

Ruft ab oder legt die IDbConnection verwendet, die durch diese Instanz von der IDbCommand.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Parameters

Ruft das IDataParameterCollection ab.(Geerbt von „DbCommand“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Transaction

Ruft ab oder legt die DbTransaction in der dieses DbCommand -Objekt ausgeführt wird.(Geerbt von „DbCommand“.)

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ückgibt.

ExecuteNonQuery

Führt Befehle wie SQL INSERT, DELETE, UPDATE und SET-Anweisungen.

ExecuteScalar

Ruft einen einzelnen Wert, z. B. einen Aggregatwert aus einer Datenbank ab.

Können Zurücksetzen der CommandText -Eigenschaft und die Wiederverwendung der OdbcCommand Objekt. Sie müssen jedoch schließen die OdbcDataReader bevor ein neuer oder zuvor verwendeter Befehl ausgeführt werden kann.

Wenn die Ausführung des Befehls eine schwerwiegende führt OdbcException z. B. eine SQL Server-Schweregrad von 20 oder höher, OdbcConnection Schließen kann. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Im folgenden Beispiel wird ExecuteNonQuery.

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

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: