OleDbCommand Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

System.Data.OleDb v11.0.0-preview.4.26230.115

Forrás:

OleDbCommand.cs

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Öröklődés

Object

DbCommand

OleDbCommand

Attribútumok

RequiresDynamicCodeAttribute

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	Leírás
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
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 .
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.
Parameters	Lekéri a OleDbParameterCollection.
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.
CreateParameter()	Új objektumpéldányt OleDbParameter 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 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.
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áson.
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(): .
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.

Lásd még

• OleDbDataAdapter
• OleDbConnection
• Parancsok használata