OleDbCommand Klas

Definitie

Naamruimte:
System.Data.OleDb
Assembly:
System.Data.dll

Vertegenwoordigt een SQL-instructie of opgeslagen procedure die moet worden uitgevoerd op basis van een gegevensbron.

public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Overname
Object
MarshalByRefObject
Component
OleDbCommand
Overname
Object
MarshalByRefObject
Component
DbCommand
OleDbCommand
Implementeringen
IDbCommand ICloneable IDisposable

Voorbeelden

In het volgende voorbeeld worden de OleDbCommandrijen in een Access-database gebruikt OleDbDataAdapter om OleDbConnectionrijen te selecteren. De opgevulde DataSet waarde wordt vervolgens geretourneerd. Het voorbeeld wordt doorgegeven aan een geïnitialiseerde DataSet, een verbindingsreeks, een queryreeks die een SQL SELECT-instructie is en een tekenreeks die de naam van de brondatabasetabel is.

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

Opmerkingen

Wanneer er een exemplaar van OleDbCommand wordt gemaakt, worden de eigenschappen voor lezen/schrijven ingesteld op de oorspronkelijke waarden. Zie de OleDbCommand constructor voor een lijst met deze waarden.

OleDbCommand bevat de volgende methoden voor het uitvoeren van opdrachten in een gegevensbron:

Onderdeel Beschrijving
ExecuteReader Hiermee worden opdrachten uitgevoerd die rijen retourneren. ExecuteReader heeft mogelijk niet het effect dat u wilt gebruiken om opdrachten zoals SQL SET-instructies uit te voeren.
ExecuteNonQuery Hiermee worden opdrachten uitgevoerd, zoals SQL INSERT, DELETE, UPDATE en SET-instructies.
ExecuteScalar Hiermee haalt u één waarde op, bijvoorbeeld een statistische waarde uit een database.

U kunt de CommandText eigenschap opnieuw instellen en het OleDbCommand object opnieuw gebruiken. U moet echter de OleDbDataReader opdracht sluiten voordat u een nieuwe of vorige opdracht kunt uitvoeren.

Als een fatale OleDbException (bijvoorbeeld een ernstniveau van SQL Server van 20 of hoger) wordt gegenereerd door de methode die een OleDbCommand uitvoert, kan de verbinding worden gesloten OleDbConnection. De gebruiker kan de verbinding echter opnieuw openen en doorgaan.

Constructors

Name Description
OleDbCommand()

Initialiseert een nieuw exemplaar van de OleDbCommand klasse.
OleDbCommand(String, OleDbConnection, OleDbTransaction)

Initialiseert een nieuw exemplaar van de OleDbCommand klasse met de tekst van de query, een OleDbConnectionen de Transaction.
OleDbCommand(String, OleDbConnection)

Initialiseert een nieuw exemplaar van de OleDbCommand klasse met de tekst van de query en een OleDbConnection.
OleDbCommand(String)

Initialiseert een nieuw exemplaar van de OleDbCommand klasse met de tekst van de query.

Eigenschappen

Name Description
CanRaiseEvents

Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren.

(Overgenomen van Component)
CommandText

Hiermee haalt u de SQL-instructie of opgeslagen procedure op die moet worden uitgevoerd op de gegevensbron.
CommandTimeout

Hiermee haalt u de wachttijd (in seconden) op of stelt u deze in voordat u een poging tot het uitvoeren van een opdracht beëindigt en een fout genereert.
CommandType

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe de CommandText eigenschap wordt geïnterpreteerd.
Connection

Hiermee haalt u de OleDbConnection gebruikt door dit exemplaar van de OleDbCommand.
Container

Hiermee haalt u het IContainer bestand op dat de Component.

(Overgenomen van Component)
DbConnection

Hiermee haalt u het DbConnection gebruikte bestand op of stelt u deze DbCommandin.

(Overgenomen van DbCommand)
DbParameterCollection

Hiermee haalt u de verzameling DbParameter objecten op.

(Overgenomen van DbCommand)
DbTransaction

Hiermee haalt u het DbTransaction object op of stelt u het DbCommand object in.

(Overgenomen van DbCommand)
DesignMode

Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is.

(Overgenomen van Component)
DesignTimeVisible

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het opdrachtobject zichtbaar moet zijn in een aangepast besturingselement Windows Forms Designer.
Events

Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld.

(Overgenomen van Component)
Parameters

Haalt de OleDbParameterCollection.
Site

Haalt of stelt de ISite van de Component.

(Overgenomen van Component)
Transaction

Hiermee haalt u de uitvoering op of stelt u deze OleDbTransactionOleDbCommand in.
UpdatedRowSource

Hiermee wordt opgehaald of ingesteld hoe de opdrachtresultaten worden toegepast op de DataRow wanneer deze worden gebruikt door de Update methode van de OleDbDataAdapter.

Methoden

Name Description
Cancel()

Probeert de uitvoering van een OleDbCommand.
Clone()

Hiermee maakt u een nieuw OleDbCommand object dat een kopie van het huidige exemplaar is.
CreateDbParameter()

Hiermee maakt u een nieuw exemplaar van een DbParameter object.

(Overgenomen van DbCommand)
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
CreateParameter()

Hiermee maakt u een nieuw exemplaar van een OleDbParameter object.
Dispose()

Alle resources die worden gebruikt door de Component.

(Overgenomen van Component)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de Component beheerde resources en brengt eventueel de beheerde resources vrij.

(Overgenomen van Component)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
ExecuteDbDataReader(CommandBehavior)

Voert de opdracht uit op basis van de verbinding en retourneert een DbDataReader opdracht die kan worden gebruikt voor toegang tot de resultaten.

(Overgenomen van DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Providers moeten deze methode implementeren om een niet-standaard implementatie te bieden voor ExecuteReader overbelastingen.

De standaardimplementatie roept de synchrone ExecuteReader() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die door ExecuteReader worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.

Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren.

(Overgenomen van DbCommand)
ExecuteNonQuery()

Hiermee wordt een SQL-instructie uitgevoerd op basis van de Connection instructie en wordt het aantal betrokken rijen geretourneerd.
ExecuteNonQueryAsync()

Een asynchrone versie van , waarmee de opdracht wordt uitgevoerd op basis van ExecuteNonQuery()het verbindingsobject, waarmee het aantal betrokken rijen wordt geretourneerd.

Roept aan ExecuteNonQueryAsync(CancellationToken) met CancellationToken.None.

(Overgenomen van DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Dit is de asynchrone versie van ExecuteNonQuery(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd.

De standaardimplementatie roept de synchrone ExecuteNonQuery() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd ExecuteNonQuery() door, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.

Roep geen andere methoden en eigenschappen van het DbCommand object aan totdat de geretourneerde taak is voltooid.

(Overgenomen van DbCommand)
ExecuteReader()

Verzendt de CommandText naar de Connection en bouwt een OleDbDataReader.
ExecuteReader(CommandBehavior)

Verzendt de CommandText naar de Connectionen bouwt een OleDbDataReader met behulp van een van de CommandBehavior waarden.
ExecuteReaderAsync()

Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten.

Roept aan ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) met CancellationToken.None.

(Overgenomen van DbCommand)
ExecuteReaderAsync(CancellationToken)

Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan.

(Overgenomen van DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan.

(Overgenomen van DbCommand)
ExecuteReaderAsync(CommandBehavior)

Een asynchrone versie van, waarmee de opdracht wordt uitgevoerd op basis van ExecuteReaderde verbinding, die een DbDataReader versie retourneert die kan worden gebruikt voor toegang tot de resultaten.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Roept aan.

(Overgenomen van DbCommand)
ExecuteScalar()

Hiermee wordt de query uitgevoerd en wordt de eerste kolom van de eerste rij in de resultatenset geretourneerd door de query. Extra kolommen of rijen worden genegeerd.
ExecuteScalarAsync()

Een asynchrone versie van ExecuteScalar(), waarmee de opdracht wordt uitgevoerd en de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset wordt geretourneerd. Alle andere kolommen, rijen en resultatensets worden genegeerd.

Roept aan ExecuteScalarAsync(CancellationToken) met CancellationToken.None.

(Overgenomen van DbCommand)
ExecuteScalarAsync(CancellationToken)

Dit is de asynchrone versie van ExecuteScalar(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd.

De standaardimplementatie roept de synchrone ExecuteScalar() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd door ExecuteScalar, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.

Roep geen andere methoden en eigenschappen van het DbCommand object aan totdat de geretourneerde taak is voltooid.

(Overgenomen van DbCommand)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLifetimeService()

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetService(Type)

Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container.

(Overgenomen van Component)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InitializeLifetimeService()

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
Prepare()

Hiermee maakt u een voorbereide (of gecompileerde) versie van de opdracht op de gegevensbron.
ResetCommandTimeout()

Hiermee stelt u de CommandTimeout eigenschap opnieuw in op de standaardwaarde.
ToString()

Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven.

(Overgenomen van Component)

gebeurtenis

Name Description
Disposed

Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode.

(Overgenomen van Component)

Expliciete interface-implementaties

Name Description
ICloneable.Clone()

Zie voor een beschrijving van dit lid Clone().
IDbCommand.Connection

Hiermee haalt u de IDbConnection gebruikt door dit exemplaar van de IDbCommand.

(Overgenomen van DbCommand)
IDbCommand.CreateParameter()

Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken.

Hiermee maakt u een nieuw exemplaar van een IDbDataParameter object.
IDbCommand.CreateParameter()

Hiermee maakt u een nieuw exemplaar van een IDbDataParameter object.

(Overgenomen van DbCommand)
IDbCommand.ExecuteReader()

Zie voor een beschrijving van dit lid ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)

Hiermee worden de CommandText waarden uitgevoerd op basis van de Connectionen wordt er een IDataReader gebouwd met behulp van een van de CommandBehavior waarden.
IDbCommand.Parameters

Haalt de IDataParameterCollection.

(Overgenomen van DbCommand)
IDbCommand.Transaction

Hiermee haalt u het DbTransaction object op of stelt u het DbCommand object in.

(Overgenomen van DbCommand)

Van toepassing op

Zie ook