OdbcCommand Osztály

Definíció

Névtér:

System.Data.Odbc

Szerelvény:

System.Data.Odbc.dll

Csomag:

System.Data.Odbc v11.0.0-preview.5.26302.115

Forrás:

OdbcCommand.cs

Sql-utasítást vagy tárolt eljárást jelöl az adatforráson való végrehajtáshoz. Ez az osztály nem örökölhető.

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

Öröklődés

Object

DbCommand

OdbcCommand

Megvalósítás

ICloneable

Példák

Az alábbi példa a következőt használja 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.
    }
}

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

Megjegyzések

Az OdbcCommand osztály a következő metódusokat kínálja a parancsok adatforráson való végrehajtásához:

Termék	Leírás
ExecuteReader	Sorokat visszaadó parancsokat hajt végre.
ExecuteNonQuery	Olyan parancsokat hajt végre, mint az SQL INSERT, a DELETE, az UPDATE és a SET utasítás.
ExecuteScalar	Egyetlen értéket, például összesített értéket kér le egy adatbázisból.

Alaphelyzetbe állíthatja a CommandText tulajdonságot, és újra felhasználhatja az OdbcCommand objektumot. Azonban be kell zárnia a OdbcDataReader parancsot, mielőtt végrehajthat egy új vagy egy korábbi parancsot.

Ha a parancs végrehajtása végzetes OdbcException, például 20 vagy több SQL Server súlyossági szintet okoz, akkor a OdbcConnection bezárulhat. A felhasználó azonban újra megnyithatja a kapcsolatot, és folytathatja azt.

Konstruktorok

Name	Description
OdbcCommand()	Inicializálja a OdbcCommand osztály új példányát.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inicializálja az OdbcCommand osztály új példányát a lekérdezés szövegével, egy OdbcConnection objektummal és a Transaction.
OdbcCommand(String, OdbcConnection)	Inicializálja az OdbcCommand osztály új példányát a lekérdezés szövegével és egy OdbcConnection objektummal.
OdbcCommand(String)	Inicializálja az OdbcCommand osztály új példányát a lekérdezés szövegével.

Tulajdonságok

Name	Description
CommandText	Lekéri vagy beállítja az SQL-utasítást vagy a tárolt eljárást az adatforráson való végrehajtáshoz.
CommandTimeout	Lekéri vagy beállítja a várakozási időt (másodpercben), mielőtt befejezi a parancs végrehajtására tett kísérletet, és hibát okozna.
CommandType	Lekéri vagy beállít egy értéket, amely jelzi a CommandText tulajdonság értelmezését.
Connection	Lekéri vagy beállítja a OdbcConnection példány által OdbcCommandhasznált .
DesignTimeVisible	Lekéri vagy beállít egy értéket, amely jelzi, hogy a parancsobjektumnak láthatónak kell-e lennie egy testreszabott felületvezérlőben.
Parameters	Lekéri a OdbcParameterCollection.
Transaction	Lekéri vagy beállítja a OdbcTransaction végrehajtást OdbcCommand .
UpdatedRowSource	Lekéri vagy beállít egy értéket, amely meghatározza, hogy az Update metódus hogyan alkalmazza a parancseredményeket a DataRow-ra.

Metódusok

Name	Description
Cancel()	Megpróbálja megszakítani a végrehajtást egy OdbcCommand.
CreateParameter()	Új objektumpéldányt OdbcParameter hoz létre.
ExecuteNonQuery()	Végrehajt egy SQL-utasítást, Connection és visszaadja az érintett sorok számát.
ExecuteReader()	Elküldi a CommandText elemet a Connection kiszolgálónak, és létrehoz egy OdbcDataReader.
ExecuteReader(CommandBehavior)	Elküldi a CommandText elemet a Connection, és létrehoz egy OdbcDataReader értéket az CommandBehavior egyik érték használatával.
ExecuteScalar()	Végrehajtja a lekérdezést, és visszaadja a lekérdezés által visszaadott eredményhalmaz első sorának első oszlopát. A rendszer figyelmen kívül hagyja a további oszlopokat vagy sorokat.
Prepare()	Létrehozza a parancs előkészített vagy lefordított verzióját az adatforrásban.
ResetCommandTimeout()	Alaphelyzetbe állítja a CommandTimeout tulajdonságot az alapértelmezett értékre.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .

Lásd még

• OdbcDataAdapter
• OdbcConnection
• Parancs végrehajtása