OdbcCommand Klasse

Definition

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Paket:: System.Data.Odbc v11.0.0-preview.2.26159.112

Quelle:: OdbcCommand.cs

Quelle:: OdbcCommand.cs

Quelle:: OdbcCommand.cs

Quelle:: OdbcCommand.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

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

public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

type OdbcCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable

Vererbung: Object

DbCommand
OdbcCommand

Vererbung: Object

MarshalByRefObject

Component

DbCommand
OdbcCommand

Vererbung: Object

MarshalByRefObject

Component
OdbcCommand

Implementiert: ICloneable IDbCommand IDisposable

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 den OdbcDataReader Befehl jedoch schließen, bevor Sie einen neuen oder vorherigen Befehl ausführen können.

Wenn die Ausführung des Befehls zu einem schwerwiegenden OdbcException Ergebnis führt, z. B. eine SQL Server-Schweregrad von 20 oder mehr, OdbcConnection kann geschlossen werden. Der Benutzer kann die Verbindung jedoch erneut öffnen und fortfahren.

Konstruktoren

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

Eigenschaften

Name	Beschreibung
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 von dieser Instanz der OdbcCommand.
Container	Ruft das, das IContainer die Component. (Geerbt von Component)
DbConnection	Dient zum Abrufen oder Festlegen der DbConnection von diesem DbCommandverwendeten . (Geerbt von DbCommand)
DbParameterCollection	Ruft die Auflistung von -Objekten ab DbParameter . (Geerbt von DbCommand)
DbTransaction	Dient zum Abrufen oder Festlegen des DbTransaction Objekts, in dem dieses DbCommand Objekt ausgeführt wird. (Geerbt von DbCommand)
DesignMode	Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit 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 OdbcParameterCollection ab.
Site	Dient zum ISite Abrufen oder Festlegen des Werts des Component. (Geerbt von Component)
Transaction	Dient zum Abrufen oder Festlegen des OdbcTransaction Werts, in dem die OdbcCommand Ausführung ausgeführt wird.
UpdatedRowSource	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie die Update-Methode Befehlsergebnisse auf DataRow anwenden soll.

Methoden

Name	Beschreibung
Cancel()	Versucht, die Ausführung einer .OdbcCommand
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()	Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
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 ein DbDataReader Element zurück, das 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 die Connection 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 ausgelöst ExecuteNonQuery() werden, werden über die zurückgegebene Task Exception-Eigenschaft mitgeteilt. Rufen Sie erst andere Methoden und Eigenschaften des `DbCommand` Objekts auf, wenn die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
ExecuteReader()	Sendet die CommandText an und Connection erstellt eine OdbcDataReader.
ExecuteReader(CommandBehavior)	Sendet den CommandText Wert an das ConnectionUnd erstellt einen OdbcDataReader mit einem der `CommandBehavior` Werte.
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt, gibt ein DbDataReader , das 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, gibt ein DbDataReader , das für den Zugriff auf die Ergebnisse verwendet werden kann. Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt, gibt ein DbDataReader , das für den Zugriff auf die Ergebnisse verwendet werden kann. Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (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, wenn 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 von der Component oder dem zugehörigen ContainerDienst bereitgestellt 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.
ResetCommandTimeout()	Setzt die CommandTimeout Eigenschaft auf den Standardwert zurück.
ToString()	Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

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

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICloneable.Clone()	Eine Beschreibung dieses Mitglieds finden Sie unter Clone().
IDbCommand.Connection	Dient zum Abrufen oder Festlegen der IDbConnection von dieser Instanz der IDbCommand. (Geerbt von DbCommand)
IDbCommand.CreateParameter()	Erstellt eine neue Instanz eines IDbDataParameter Objekts.
IDbCommand.CreateParameter()	Erstellt eine neue Instanz eines IDbDataParameter Objekts. (Geerbt von DbCommand)
IDbCommand.ExecuteReader()	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Führt die CommandText gegen die Connection und erstellt eine IDataReader.
IDbCommand.ExecuteReader()	Führt die CommandText gegen die Connection und erstellt eine IDataReader. (Geerbt von DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Führt den CommandText Gegen-Wert Connectionaus und erstellt ein IDataReader mithilfe des angegebenen Verhaltens.
IDbCommand.ExecuteReader(CommandBehavior)	Führt den CommandText Gegenwert Connectionaus und erstellt einen IDataReader mit einem der CommandBehavior Werte. (Geerbt von DbCommand)
IDbCommand.Parameters	Ruft IDataParameterCollection ab. (Geerbt von DbCommand)
IDbCommand.Transaction	Dient zum Abrufen oder Festlegen des DbTransaction Objekts, in dem dieses DbCommand Objekt ausgeführt wird. (Geerbt von DbCommand)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?