DbCommand Sınıf

Tanım

Bir veri kaynağında yürütülecek bir SQL ifadesini veya saklı yordamı temsil eder.Represents an SQL statement or stored procedure to execute against a data source. Komutları temsil eden veritabanına özgü sınıflar için bir temel sınıf sağlar.Provides a base class for database-specific classes that represent commands. ExecuteNonQueryAsync

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
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, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
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
    interface IAsyncDisposable
type DbCommand = class
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, 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
Devralma
DbCommand
Devralma
Türetilmiş
Uygulamalar

Oluşturucular

DbCommand()

Nesnesinin bir örneğini oluşturur DbCommand .Constructs an instance of the DbCommand object.

Özellikler

CanRaiseEvents

Bileşenin bir olay yapıp yapamayacağını gösteren bir değer alır.Gets a value indicating whether the component can raise an event.

(Devralındığı yer: Component)
CommandText

Türetilmiş bir sınıfta geçersiz kılındığında, metin komutunu veri kaynağında çalıştırılacak şekilde alır veya ayarlar.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout

Türetilmiş bir sınıfta geçersiz kılındığında, bir komutu yürütme ve hata oluşturma girişimini sonlandırmadan önce bekleme süresini (saniye cinsinden) alır veya ayarlar.When overridden in a derived class, gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Türetilmiş bir sınıfta geçersiz kılındığında, özelliğin nasıl yorumlandığını alır veya ayarlar CommandText .When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection

DbConnectionBunun tarafından kullanılan tarafından alır veya ayarlar DbCommand .Gets or sets the DbConnection used by this DbCommand.

Container

Öğesini içeren öğesini alır IContainer Component .Gets the IContainer that contains the Component.

(Devralındığı yer: Component)
DbConnection

Türetilmiş bir sınıfta geçersiz kılındığında, bu tarafından kullanılan ' ı alır veya ayarlar DbConnection DbCommand .When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

DbParameterCollection

Türetilmiş bir sınıfta geçersiz kılındığında, nesne koleksiyonunu alır DbParameter .When overridden in a derived class, gets the collection of DbParameter objects.

DbTransaction

Türetilmiş bir sınıfta geçersiz kılındığında, bu nesnenin içinde çalıştırıldığı ' ı alır veya ayarlar DbTransaction DbCommand .When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode

Şu anda Tasarım modunda olup olmadığını gösteren bir değer alır Component .Gets a value that indicates whether the Component is currently in design mode.

(Devralındığı yer: Component)
DesignTimeVisible

Türetilmiş bir sınıfta geçersiz kılındığında, komut nesnesinin özelleştirilmiş bir arabirim denetiminde görünür olup olmayacağını gösteren bir değer alır veya ayarlar.When overridden in a derived class, gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events

Bu öğesine eklenen olay işleyicilerinin listesini alır Component .Gets the list of event handlers that are attached to this Component.

(Devralındığı yer: Component)
Parameters

Nesne koleksiyonunu alır DbParameter .Gets the collection of DbParameter objects. Parametreler hakkında daha fazla bilgi için bkz. parametreleri ve parametre veri türlerini yapılandırma.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site

Öğesini alır veya ayarlar ISite Component .Gets or sets the ISite of the Component.

(Devralındığı yer: Component)
Transaction

DbTransactionBu nesnenin içinde çalıştırıldığı içindeki öğesini alır veya ayarlar DbCommand .Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource

Türetilmiş bir sınıfta geçersiz kılındığında, komut sonuçlarının DataRow öğesinin Update yöntemi tarafından kullanıldığında öğesine nasıl uygulanacağını alır veya ayarlar DbDataAdapter .When overridden in a derived class, gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Yöntemler

Cancel()

Türetilmiş bir sınıfta geçersiz kılınırsa, yürütmesini iptal etmeyi dener DbCommand .When overridden in a derived class, attempts to cancel the execution of a DbCommand.

CreateDbParameter()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir nesnenin yeni bir örneğini oluşturur DbParameter .When overridden in a derived class, creates a new instance of a DbParameter object.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Devralındığı yer: MarshalByRefObject)
CreateParameter()

Bir nesnenin yeni bir örneğini oluşturur DbParameter .Creates a new instance of a DbParameter object.

Dispose()

Uygulama tarafından tanımlanan, yönetilmeyen kaynakları serbest bırakma, salma veya sıfırlama ile ilişkili görevleri gerçekleştirir.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.Releases all resources used by the Component.

(Devralındığı yer: Component)
Dispose(Boolean)

DbCommand tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

Dispose(Boolean)

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Devralındığı yer: Component)
DisposeAsync()

Komut nesnesini zaman uyumsuz olarak atar.Asynchronously diposes the command object.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
ExecuteDbDataReader(CommandBehavior)

Türetilmiş bir sınıfta geçersiz kılınırsa, bağlantı için komut metnini yürütür.When overridden in a derived class, executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Sağlayıcılar, aşırı yüklemeler için varsayılan olmayan bir uygulama sağlamak üzere bu yöntemi uygulamalıdır ExecuteReader .Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Varsayılan uygulama, zaman uyumlu ExecuteReader() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Bu yöntem, işlemi erken iptal edilecek şekilde istemek için kullanılabilen bir iptal belirtecini kabul eder.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Uygulamalar bu isteği yok sayabilir.Implementations may ignore this request.

ExecuteNonQuery()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir bağlantı nesnesine karşı bir SQL ifadesini yürütür.When overridden in a derived class, executes a SQL statement against a connection object.

ExecuteNonQueryAsync()

Bir ExecuteNonQuery() bağlantı nesnesine yönelik BIR SQL ifadesini yürüten zaman uyumsuz bir sürümü.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

ExecuteNonQueryAsync(CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür ExecuteNonQuery() .This is the asynchronous version of ExecuteNonQuery(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. İptal belirteci isteğe bağlı olarak yoksayılabilir.The cancellation token may optionally be ignored.

Varsayılan uygulama, zaman uyumlu ExecuteNonQuery() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Tarafından oluşturulan özel durumlar ExecuteNonQuery() , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Döndürülen görev tamamlanana kadar nesnenin diğer yöntemlerini ve özelliklerini çağırmayın DbCommand .Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader()

CommandText Connection ' I ' a karşı yürütür ve döndürür DbDataReader .Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior)

CommandText Connection ' I ' a karşı yürütür ve DbDataReader değerlerinden birini kullanarak döndürür CommandBehavior .Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken)

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Bu yöntem, işlemlerin iptal edilmesi gerektiğini belirten bir bildirim yayar.This method propagates a notification that operations should be canceled.

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

ExecuteReader' I ' CommandText a karşı yürüten Connection ve döndüren zaman uyumsuz bir sürümü DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Çağırır ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

Türetilmiş bir sınıfta geçersiz kılınırsa, sorguyu yürütür ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndürür.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. Diğer tüm sütunlar ve satırlar yok sayılır.All other columns and rows are ignored.

ExecuteScalarAsync()

ExecuteScalar()Sorgusunu yürüten ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz bir sürümü.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Diğer tüm sütunlar ve satırlar yok sayılır.All other columns and rows are ignored.

ExecuteScalarAsync(CancellationToken)CancellationToken. None ile çağırır.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür ExecuteScalar() .This is the asynchronous version of ExecuteScalar(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. İptal belirteci isteğe bağlı olarak yoksayılabilir.The cancellation token may optionally be ignored.

Varsayılan uygulama, zaman uyumlu ExecuteScalar() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader metodunu tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Döndürülen görev tamamlanana kadar nesnenin diğer yöntemlerini ve özelliklerini çağırmayın DbCommand .Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetService(Type)

Veya tarafından belirtilen bir hizmeti temsil eden bir nesne döndürür Component Container .Returns an object that represents a service provided by the Component or by its Container.

(Devralındığı yer: Component)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
InitializeLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Devralındığı yer: MarshalByRefObject)
Prepare()

Türetilmiş bir sınıfta geçersiz kılınırsa, veri kaynağında komutun hazırlanmış (veya derlenen) bir sürümünü oluşturur.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken)

Zaman uyumsuz olarak, veri kaynağında komutun hazırlanmış (veya derlenen) bir sürümünü oluşturur.Asynchronously creates a prepared (or compiled) version of the command on the data source.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
ToString()

Varsa, String varsa adını içeren bir döndürür Component .Returns a String containing the name of the Component, if any. Bu yöntem geçersiz kılınmamalıdır.This method should not be overridden.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yönteme bir çağrı tarafından bırakıldığında gerçekleşir Dispose() .Occurs when the component is disposed by a call to the Dispose() method.

(Devralındığı yer: Component)

Belirtik Arabirim Kullanımları

IDbCommand.Connection

IDbConnectionBu örneği tarafından kullanılan öğesini alır veya ayarlar IDbCommand .Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter()

Bir nesnenin yeni bir örneğini oluşturur IDbDataParameter .Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader()

' A CommandText karşı yürütülür Connection ve bir oluşturur IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

, CommandText ' A karşı yürütülür Connection ve IDataReader değerlerden birini kullanarak bir oluşturur CommandBehavior .Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters

IDataParameterCollection öğesini alır.Gets the IDataParameterCollection.

IDbCommand.Transaction

DbTransactionBu nesnenin içinde çalıştırıldığı içindeki öğesini alır veya ayarlar DbCommand .Gets or sets the DbTransaction within which this DbCommand object executes.

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir döndürülen görevlerin ne kadar beklediğini yapılandırır.Configures how awaits on the tasks returned from an async disposable are performed.

Şunlara uygulanır

Ayrıca bkz.