OleDbCommand Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.dll

Sql-utasítást vagy tárolt eljárást jelöl az adatforráson való végrehajtáshoz.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Öröklődés

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Megvalósítás

IDbCommand ICloneable IDisposable

Példák

Az alábbi példa az Access-adatbázis sorainak kijelölésére használja a OleDbCommandmentén OleDbDataAdapter és OleDbConnectiona mellette lévő sorokat. Ezután visszaadja a kitöltött elemet DataSet . A példa egy inicializált DataSet, egy kapcsolati karakterlánc, egy SQL SELECT utasítást tartalmazó lekérdezési sztring és a forrásadatbázis-tábla neve.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Megjegyzések

Amikor létrejön egy példány OleDbCommand , az olvasási/írási tulajdonságok a kezdeti értékükre lesznek állítva. Ezeknek az értékeknek a listáját a konstruktorban OleDbCommand találja.

OleDbCommand az alábbi metódusokkal hajt végre parancsokat egy adatforráson:

Termék	Description
ExecuteReader	Sorokat visszaadó parancsokat hajt végre. ExecuteReader előfordulhat, hogy a parancsok( például SQL SET-utasítások) végrehajtására használt parancsok nem rendelkeznek a kívánt hatással.
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 OleDbCommand objektumot. Azonban be kell zárnia a OleDbDataReader parancsot, mielőtt végrehajthat egy új vagy egy korábbi parancsot.

Ha végzetes OleDbException (például 20 vagy annál nagyobb SQL Server súlyossági szint) jön létre egy OleDbCommand végrehajtó metódus, a OleDbConnection, a kapcsolat bezárható. A felhasználó azonban újra megnyithatja a kapcsolatot, és folytathatja azt.

Konstruktorok

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

Tulajdonságok

Name	Description
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
CommandText	Lekéri vagy beállítja az SQL-utasítást vagy a tárolt eljárást az adatforrásban 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 OleDbConnection példány által OleDbCommandhasznált .
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DbConnection	Lekéri vagy beállítja a DbConnection használt elemet.DbCommand (Öröklődés forrása DbCommand)
DbParameterCollection	Lekéri az objektumok gyűjteményét DbParameter . (Öröklődés forrása DbCommand)
DbTransaction	Lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbCommand alapjául szolgáló objektumot. (Öröklődés forrása DbCommand)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
DesignTimeVisible	Lekéri vagy beállít egy értéket, amely jelzi, hogy a parancsobjektumnak láthatónak kell-e lennie egy testreszabott Windows Forms Designer-vezérlőben.
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
Parameters	Lekéri a OleDbParameterCollection.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Transaction	Lekéri vagy beállítja a OleDbTransaction végrehajtást OleDbCommand .
UpdatedRowSource	Lekérdezi vagy beállítja, hogy a parancseredmények hogyan legyenek alkalmazva a DataRowUpdateOleDbDataAdaptermetódus által használt parancsokra.

Metódusok

Name	Description
Cancel()	Megpróbálja megszakítani a végrehajtást egy OleDbCommand.
Clone()	Létrehoz egy új OleDbCommand objektumot, amely az aktuális példány másolata.
CreateDbParameter()	Új objektumpéldányt DbParameter hoz létre. (Öröklődés forrása DbCommand)
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
CreateParameter()	Új objektumpéldányt OleDbParameter hoz létre.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExecuteDbDataReader(CommandBehavior)	Végrehajtja a parancsot a kapcsolaton, és visszaad egy DbDataReader olyan parancsot, amely az eredmények eléréséhez használható. (Öröklődés forrása DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	A szolgáltatóknak ezt a módszert úgy kell implementálniuk, hogy a túlterhelések nem alapértelmezett implementációt biztosítsanak ExecuteReader . Az alapértelmezett implementáció meghívja a szinkron ExecuteReader() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteReader által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve. Ez a metódus elfogad egy lemondási jogkivonatot, amely a művelet korai törlésének igénylésére használható. A megvalósítások figyelmen kívül hagyhatják ezt a kérést. (Öröklődés forrása DbCommand)
ExecuteNonQuery()	Végrehajt egy SQL-utasítást, Connection és visszaadja az érintett sorok számát.
ExecuteNonQueryAsync()	A parancsot a kapcsolati objektumon futtató aszinkron verziója ExecuteNonQuery(), amely az érintett sorok számát adja vissza. Meghívja ExecuteNonQueryAsync(CancellationToken) a CancellationToken.None parancsot. (Öröklődés forrása DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Ez aszinkron verziója.ExecuteNonQuery() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat opcionálisan figyelmen kívül hagyható. Az alapértelmezett implementáció meghívja a szinkron ExecuteNonQuery() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. A rendszer ExecuteNonQuery() a visszaadott Tevékenységkivétel tulajdonságon keresztül közli a kivételeket. Ne hívja meg az DbCommand objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik. (Öröklődés forrása DbCommand)
ExecuteReader()	Elküldi a CommandText elemet a Connection kiszolgálónak, és létrehoz egy OleDbDataReader.
ExecuteReader(CommandBehavior)	Elküldi a CommandText elemet a Connection, és létrehoz egy OleDbDataReader értéket az CommandBehavior egyik érték használatával.
ExecuteReaderAsync()	A parancsot a kapcsolaton keresztül végrehajtó aszinkron verziója ExecuteReader, amely az eredmények eléréséhez használható értéket ad vissza DbDataReader . Meghívja ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) a CancellationToken.None parancsot. (Öröklődés forrása DbCommand)
ExecuteReaderAsync(CancellationToken)	A parancsot a kapcsolaton keresztül végrehajtó aszinkron verziója ExecuteReader, amely az eredmények eléréséhez használható értéket ad vissza DbDataReader . Meghívja.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) (Öröklődés forrása DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Meghívja.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) (Öröklődés forrása DbCommand)
ExecuteReaderAsync(CommandBehavior)	A parancsot a kapcsolaton keresztül végrehajtó aszinkron verziója ExecuteReader, amely az eredmények eléréséhez használható értéket ad vissza DbDataReader . Meghívja.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) (Öröklődés forrása DbCommand)
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.
ExecuteScalarAsync()	A parancsot végrehajtó aszinkron verzió ExecuteScalar(), amely az első visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt. Meghívja ExecuteScalarAsync(CancellationToken) a CancellationToken.None parancsot. (Öröklődés forrása DbCommand)
ExecuteScalarAsync(CancellationToken)	Ez aszinkron verziója.ExecuteScalar() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat opcionálisan figyelmen kívül hagyható. Az alapértelmezett implementáció meghívja a szinkron ExecuteScalar() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteScalar által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve. Ne hívja meg az DbCommand objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik. (Öröklődés forrása DbCommand)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által ComponentContainernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
Prepare()	Létrehozza a parancs előkészített (vagy lefordított) verzióját az adatforráson.
ResetCommandTimeout()	Alaphelyzetbe állítja a CommandTimeout tulajdonságot az alapértelmezett értékre.
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .
IDbCommand.Connection	Lekéri vagy beállítja a IDbConnection példány által IDbCommandhasznált . (Öröklődés forrása DbCommand)
IDbCommand.CreateParameter()	Új objektumpéldányt IDbDataParameter hoz létre. (Öröklődés forrása DbCommand)
IDbCommand.ExecuteReader()	Ennek a tagnak a leírását lásd ExecuteReader(): .
IDbCommand.ExecuteReader(CommandBehavior)	Végrehajtja az CommandText ellent Connection, és létrehoz egy IDataReader értéket az CommandBehavior egyik érték használatával.
IDbCommand.Parameters	Lekéri a IDataParameterCollection. (Öröklődés forrása DbCommand)
IDbCommand.Transaction	Lekéri vagy beállítja az DbTransaction objektum végrehajtásának DbCommand alapjául szolgáló objektumot. (Öröklődés forrása DbCommand)

Lásd még

• OleDbDataAdapter
• OleDbConnection
• Parancsok használata