DbCommand Klass

Definition

Namnområde:
System.Data.Common
Sammansättning:
System.Data.Common.dll
Sammansättning:
System.Data.dll
Sammansättning:
netstandard.dll

Representerar en SQL-instruktion eller lagrad procedur som ska köras mot en datakälla. Tillhandahåller en basklass för databasspecifika klasser som representerar kommandon. ExecuteNonQueryAsync.

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Arv
Object
DbCommand
Arv
Object
MarshalByRefObject
Component
DbCommand
Härledda
Implementeringar
IDisposable IDbCommand IAsyncDisposable

Konstruktorer

Name Description
DbCommand()

Konstruerar en instans av DbCommand objektet.

Egenskaper

Name Description
CanRaiseEvents

Hämtar ett värde som anger om komponenten kan generera en händelse.

(Ärvd från Component)
CommandText

Hämtar eller anger att textkommandot ska köras mot datakällan.
CommandTimeout

Hämtar eller anger väntetiden (i sekunder) innan du avslutar försöket att köra kommandot och genererar ett fel.
CommandType

Hämtar eller anger hur egenskapen CommandText tolkas.
Connection

Hämtar eller anger den DbConnection som används av den här DbCommand.
Container

Hämtar som IContainer innehåller Component.

(Ärvd från Component)
DbConnection

Hämtar eller anger den DbConnection som används av den här DbCommand.
DbParameterCollection

Hämtar samlingen med DbParameter objekt.
DbTransaction

Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs.
DesignMode

Hämtar ett värde som anger om det Component för närvarande är i designläge.

(Ärvd från Component)
DesignTimeVisible

Hämtar eller anger ett värde som anger om kommandoobjektet ska visas i en anpassad gränssnittskontroll.
Events

Hämtar listan över händelsehanterare som är kopplade till den här Component.

(Ärvd från Component)
Parameters

Hämtar samlingen med DbParameter objekt. Mer information om parametrar finns i Konfigurera parametrar och parameterdatatyper.
Site

Hämtar eller ställer in ISite i Component.

(Ärvd från Component)
Transaction

Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs.
UpdatedRowSource

Hämtar eller anger hur kommandoresultat tillämpas på DataRow när de används av metoden Uppdatera för en DbDataAdapter.

Metoder

Name Description
Cancel()

Försök att avbryta körningen av en DbCommand.
CreateDbParameter()

Skapar en ny instans av ett DbParameter objekt.
CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
CreateParameter()

Skapar en ny instans av ett DbParameter objekt.
Dispose()

Utför programdefinierade uppgifter som är associerade med att frigöra, frigöra eller återställa ohanterade resurser.
Dispose()

Släpper alla resurser som används av Component.

(Ärvd från Component)
Dispose(Boolean)

Släpper de ohanterade resurser som används av DbCommand och släpper eventuellt de hanterade resurserna.
Dispose(Boolean)

Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna.

(Ärvd från Component)
DisposeAsync()

Tar bort kommandoobjektet asynkront.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
ExecuteDbDataReader(CommandBehavior)

Kör kommandot mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Leverantörer bör implementera den här metoden för att tillhandahålla en icke-standardimplementering för ExecuteReader överlagringar.

Standardimplementeringen anropar den synkrona ExecuteReader() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteReader kommuniceras via den returnerade egenskapen Aktivitetsfel.

Den här metoden accepterar en annulleringstoken som kan användas för att begära att åtgärden avbryts tidigt. Implementeringar kan ignorera den här begäran.
ExecuteNonQuery()

Kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas.
ExecuteNonQueryAsync()

En asynkron version av ExecuteNonQuery(), som kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas.

Anropar ExecuteNonQueryAsync(CancellationToken) med CancellationToken.None.
ExecuteNonQueryAsync(CancellationToken)

Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.

Standardimplementeringen anropar den synkrona ExecuteNonQuery() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteNonQuery() kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel.

Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.
ExecuteReader()

Kör kommandot mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteReader(CommandBehavior)

Kör kommandot mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteReaderAsync()

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) med CancellationToken.None.
ExecuteReaderAsync(CancellationToken)

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior)

En asynkron version av ExecuteReader, som kör kommandot mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.

Anropar ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteScalar()

Kör kommandot och returnerar den första kolumnen i den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.
ExecuteScalarAsync()

En asynkron version av ExecuteScalar(), som kör kommandot och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.

Anropar ExecuteScalarAsync(CancellationToken) med CancellationToken.None.
ExecuteScalarAsync(CancellationToken)

Det här är den asynkrona versionen av ExecuteScalar(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.

Standardimplementeringen anropar den synkrona ExecuteScalar() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteScalar kommuniceras via den returnerade egenskapen Aktivitetsfel.

Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLifetimeService()

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetService(Type)

Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container.

(Ärvd från Component)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
InitializeLifetimeService()

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
Prepare()

Skapar en förberedd (eller kompilerad) version av kommandot på datakällan.
PrepareAsync(CancellationToken)

Asynkront skapar en förberedd (eller kompilerad) version av kommandot på datakällan.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
ToString()

Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas.

(Ärvd från Component)

Händelser

Name Description
Disposed

Inträffar när komponenten tas bort av ett anrop till Dispose() metoden.

(Ärvd från Component)

Explicita gränssnittsimplementeringar

Name Description
IDbCommand.Connection

Hämtar eller anger den IDbConnection som används av den här instansen IDbCommandav .
IDbCommand.CreateParameter()

Skapar en ny instans av ett IDbDataParameter objekt.
IDbCommand.ExecuteReader()

CommandText Kör mot Connection och skapar en IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)

CommandText Kör mot Connection, och skapar ett IDataReader med något av CommandBehavior värdena.
IDbCommand.Parameters

IDataParameterCollectionHämtar .
IDbCommand.Transaction

Hämtar eller anger inom DbTransaction vilken det här DbCommand objektet körs.

Tilläggsmetoder

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfigurerar hur väntar på de uppgifter som returneras från en asynkron disponibel ska utföras.

Gäller för

Se även