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
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 sealed class OleDbCommand : 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
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
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Devralma
OleDbCommand
Devralma
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnekte, Access veritabanından OleDbCommandsatır seçmek için , ve ile birlikte OleDbDataAdapterOleDbConnectionkullanılır. Doldurulan DataSet daha sonra döndürülür. Örnek, başlatılan DataSetbir , 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 örneği OleDbCommand oluşturulduğunda, okuma/yazma özellikleri ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya OleDbCommand bakın.

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

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

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

Bir yürüten OleDbCommandOleDbConnectionyöntem tarafından önemli OleDbException bir (örneğin, SQL Server önem derecesi 20 veya üzeri) 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 sınıfının yeni bir örneğini OleDbCommand başlatır.

OleDbCommand(String, OleDbConnection)

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

OleDbCommand(String, OleDbConnection, OleDbTransaction)

sorgu metni OleDbCommand , bir ve ile sınıfının yeni bir OleDbConnectionörneğini Transactionbaş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

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

Connection

öğesinin OleDbConnection bu örneği tarafından kullanılan öğesini OleDbCommandalır veya ayarlar.

Container

öğesini IContainer içeren öğesini Componentalır.

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

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

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

Nesne koleksiyonunu DbParameter alır.

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

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

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

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

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

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

Events

Bu Componentöğesine eklenen olay işleyicilerinin listesini alır.

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

OleDbParameterCollection öğesini alır.

Site

öğesini alır veya ayarlar ISiteComponent.

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

öğesinin OleDbTransaction yürütüldiği öğesini OleDbCommand alır veya ayarlar.

UpdatedRowSource

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

Yöntemler

Cancel()

yürütmesini OleDbCommandiptal etmeye çalışır.

Clone()

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

CreateDbParameter()

Nesnenin yeni bir DbParameter ö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()

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

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.

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

Component tarafı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 yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

(Devralındığı yer: DbCommand)
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.

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

Komut nesnesini zaman uyumsuz olarak batırı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, aşırı yüklemeler için varsayılan olmayan bir uygulama sağlamak üzere ExecuteReader bu yöntemi uygulamalıdır.

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

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

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

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

ExecuteNonQueryAsync()

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

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

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

Bu, zaman uyumsuz sürümüdür ExecuteNonQuery(). 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öntemi çağırır ve çağrılan iş parçacığını engelleyen tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirtecinden geçildiyse iptal edilmiş bir görev döndürür. tarafından ExecuteNonQuery() 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 nesnenin DbCommand diğer yöntemlerini ve özelliklerini çağırmayın.

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

öğesine CommandTextConnection gönderir ve bir OleDbDataReaderoluşturur.

ExecuteReader(CommandBehavior)

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

ExecuteReaderAsync()

Komutunu bağlantısında yürüten ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndüren zaman uyumsuz sürümüExecuteReader.

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

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

Komutunu bağlantısında yürüten ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndüren zaman uyumsuz sürümüExecuteReader.

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

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

Komutunu bağlantısında yürüten ve sonuçlara erişmek için kullanılabilecek bir DbDataReader döndüren zaman uyumsuz sürümüExecuteReader.

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

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

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)öğesini ç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 zaman uyumsuz sürümü ExecuteScalar(). Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır.

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

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

Bu, zaman uyumsuz sürümüdür ExecuteScalar(). 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öntemi çağırır ve çağrılan iş parçacığını engelleyen tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirtecinden geçildiyse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşturulan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar nesnenin DbCommand 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)

veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

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

Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur.

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

Geçerli MarshalByRefObject nesnenin 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()

Özelliği varsayılan değere sıfırlar CommandTimeout .

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

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

Varsa, adını Componentiç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 yöntemine Dispose() yapılan bir çağrı tarafından 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

öğesinin IDbConnection bu örneği tarafından kullanılan öğesini IDbCommandalı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.

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

IDbCommand.CreateParameter()

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

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

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

IDbCommand.ExecuteReader(CommandBehavior)

üzerinde komutunu CommandTextConnectionyürütür ve değerlerden CommandBehavior birini kullanarak bir IDataReader oluşturur.

IDbCommand.Parameters

IDataParameterCollection öğesini alır.

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

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

(Devralındığı yer: DbCommand)

Şunlara uygulanır

Ayrıca bkz.