OleDbCommand Sınıf

Tanım

Bir veri kaynağında yürütülecek SQL deyimini veya saklı yordamı temsil eder.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : 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
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
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 DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Devralma
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnek, Access veritabanından satır seçmek için OleDbDataAdapter ve OleDbConnectionboyunca OleDbCommandkullanır. Daha sonra doldurulmuş DataSet döndürülür. Örnek, başlatılan bir DataSet, bağlantı dizesi, SQL SELECT deyimi olan bir sorgu dizesi ve kaynak veritabanı tablosunun adı olan bir dize geçirilir.

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

Açıklamalar

bir OleDbCommand örneği oluşturulduğunda, okuma/yazma özellikleri ilk değerlerine ayarlanır. Bu değerlerin listesi için bkz. OleDbCommand oluşturucu.

OleDbCommand, bir veri kaynağında komutları yürüten aşağıdaki yöntemleri içerir:

Madde Açıklama
ExecuteReader Satır döndüren komutları yürütür. ExecuteReader, SQL SET deyimleri gibi komutları yürütmek için kullanıldığında istediğiniz etkiye sahip olmayabilir.
ExecuteNonQuery SQL INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür.
ExecuteScalar Bir veritabanından toplama değeri gibi tek bir değer alır.

CommandText özelliğini sıfırlayabilir ve OleDbCommand nesnesini yeniden kullanabilirsiniz. Ancak, yeni veya önceki bir komutu yürütebilmeniz için önce OleDbDataReader kapatmanız gerekir.

Bir OleDbCommand(OleDbConnection) yürüten yöntem tarafından önemli bir OleDbException (örneğin, 20 veya üzeri bir SQL Server önem düzeyi) oluşturulursa, bağlantı kapatılabilir. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Oluşturucular

OleDbCommand()

OleDbCommand sınıfının yeni bir örneğini başlatır.

OleDbCommand(String)

sorgu metniyle OleDbCommand sınıfının yeni bir örneğini başlatır.

OleDbCommand(String, OleDbConnection)

OleDbCommand sınıfının yeni bir örneğini sorgu metni ve OleDbConnectionile başlatır.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

OleDbCommand sınıfının yeni bir örneğini sorgu metni, bir OleDbConnectionve Transactionile başlatır.

Özellikler

CanRaiseEvents

Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır.

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

Veri kaynağında yürütülecek SQL deyimini veya saklı yordamı alır veya ayarlar.

CommandTimeout

Komut yürütme girişimini sonlandırmadan ve hata oluşturmadan önce bekleme süresini (saniye cinsinden) alır veya ayarlar.

CommandType

CommandText özelliğinin nasıl yorumlandığını gösteren bir değer alır veya ayarlar.

Connection

OleDbCommandbu örneği tarafından kullanılan OleDbConnection alır veya ayarlar.

Container

Componentiçeren IContainer alır.

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

Bu DbCommandtarafından kullanılan DbConnection alır veya ayarlar.

(Devralındığı yer: DbCommand)
DbParameterCollection

DbParameter nesneleri koleksiyonunu alır.

(Devralındığı yer: DbCommand)
DbTransaction

Bu DbCommand nesnesinin yürütüldiği DbTransaction alır veya ayarlar.

(Devralındığı yer: DbCommand)
DesignMode

Component şu anda tasarım modunda olup olmadığını gösteren bir değer alır.

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

Komut nesnesinin özelleştirilmiş bir Windows Forms Designer denetiminde görünür olup olmayacağını gösteren bir değer alır veya ayarlar.

Events

Bu Componenteklenen olay işleyicilerinin listesini alır.

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

OleDbParameterCollectionalır.

Site

Component ISite alır veya ayarlar.

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

OleDbCommand yürütülürken OleDbTransaction alır veya ayarlar.

UpdatedRowSource

OleDbDataAdapter Update yöntemi tarafından kullanıldığında komut sonuçlarının DataRow nasıl uygulanacağını alır veya ayarlar.

Yöntemler

Cancel()

OleDbCommandyürütmeyi iptal etmeye çalışır.

Clone()

Geçerli örneğin kopyası olan yeni bir OleDbCommand nesnesi oluşturur.

CreateDbParameter()

DbParameter nesnesinin yeni bir örneğini oluşturur.

(Devralındığı yer: DbCommand)
CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

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

OleDbParameter nesnesinin yeni bir örneğini oluşturur.

Dispose()

Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.

(Devralındığı yer: DbCommand)
Dispose()

Componenttarafından kullanılan tüm kaynakları serbest bırakır.

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

DbCommand tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.

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

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.

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

Komut nesnesini zaman uyumsuz olarak daraltıyor.

(Devralındığı yer: DbCommand)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

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

Komutu bağlantısında yürütür ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndürür.

(Devralındığı yer: DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Sağlayıcılar, ExecuteReader aşırı yüklemeleri için varsayılan olmayan bir uygulama sağlamak üzere bu yöntemi uygulamalıdır.

Varsayılan uygulama zaman uyumlu ExecuteReader() yöntemini çağırır ve çağrılan iş parçacığını engelleyerek tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteReader tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Bu yöntem, işlemin erken iptalini istemek için kullanılabilecek bir iptal belirteci kabul eder. Uygulamalar bu isteği yoksayabilir.

(Devralındığı yer: DbCommand)
ExecuteNonQuery()

Connection karşı bir SQL deyimi yürütür ve etkilenen satır sayısını döndürür.

ExecuteNonQueryAsync()

ExecuteNonQuery()zaman uyumsuz sürümü, komutu bağlantı nesnesine karşı yürütür ve etkilenen satır sayısını döndürür.

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

(Devralındığı yer: DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Bu, ExecuteNonQuery()zaman uyumsuz sürümüdür. Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak yoksayılabilir.

Varsayılan uygulama zaman uyumlu ExecuteNonQuery() yöntemini çağırır ve çağrılan iş parçacığını engelleyerek tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteNonQuery() tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar DbCommand nesnesinin diğer yöntemlerini ve özelliklerini çağırmayın.

(Devralındığı yer: DbCommand)
ExecuteReader()

CommandText Connection gönderir ve bir OleDbDataReaderoluşturur.

ExecuteReader(CommandBehavior)

CommandText Connectiongönderir ve CommandBehavior değerlerinden birini kullanarak bir OleDbDataReader oluşturur.

ExecuteReaderAsync()

ExecuteReaderzaman uyumsuz sürümü, komutu bağlantısında yürütür ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndürür.

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

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CancellationToken)

ExecuteReaderzaman uyumsuz sürümü, komutu bağlantısında yürütür ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndürür.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)çağırır.

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CommandBehavior)

ExecuteReaderzaman uyumsuz sürümü, komutu bağlantısında yürütür ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndürür.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)çağırır.

(Devralındığı yer: DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)çağırır.

(Devralındığı yer: DbCommand)
ExecuteScalar()

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. Ek sütunlar veya satırlar yoksayılır.

ExecuteScalarAsync()

komutunu yürüten ve döndürülen ilk sonuç kümesindeki ilk satırın ilk sütununu döndüren ExecuteScalar()zaman uyumsuz sürümü. Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır.

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

(Devralındığı yer: DbCommand)
ExecuteScalarAsync(CancellationToken)

Bu, ExecuteScalar()zaman uyumsuz sürümüdür. Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak yoksayılabilir.

Varsayılan uygulama zaman uyumlu ExecuteScalar() yöntemini çağırır ve çağrılan iş parçacığını engelleyerek tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar DbCommand nesnesinin diğer yöntemlerini ve özelliklerini çağırmayın.

(Devralındığı yer: DbCommand)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

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

Component veya Containertarafından sağlanan bir hizmeti temsil eden bir nesnesi döndürür.

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

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

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

Geçerli Objectbasit bir kopyasını oluşturur.

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

Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur.

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

Veri kaynağında komutun hazırlanmış (veya derlenmiş) bir sürümünü oluşturur.

PrepareAsync(CancellationToken)

Veri kaynağında komutun hazırlanmış (veya derlenmiş) bir sürümünü zaman uyumsuz olarak oluşturur.

(Devralındığı yer: DbCommand)
ResetCommandTimeout()

CommandTimeout özelliğini varsayılan değere sıfırlar.

ToString()

varsa, Componentadını içeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen Dispose() yöntemine yapılan bir çağrıyla atıldığında gerçekleşir.

(Devralındığı yer: Component)

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Bu üyenin açıklaması için bkz. Clone().

IDbCommand.Connection

IDbCommandbu örneği tarafından kullanılan IDbConnection alır veya ayarlar.

(Devralındığı yer: DbCommand)
IDbCommand.CreateParameter()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

IDbDataParameter nesnesinin yeni bir örneğini oluşturur.

IDbCommand.CreateParameter()

IDbDataParameter nesnesinin yeni bir örneğini oluşturur.

(Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader()

Bu üyenin açıklaması için bkz. ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Connectionüzerinde CommandText yürütür ve CommandBehavior değerlerinden birini kullanarak bir IDataReader oluşturur.

IDbCommand.Parameters

IDataParameterCollectionalır.

(Devralındığı yer: DbCommand)
IDbCommand.Transaction

Bu DbCommand nesnesinin yürütüldiği DbTransaction alır veya ayarlar.

(Devralındığı yer: DbCommand)

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılır.

Şunlara uygulanır

Ayrıca bkz.