OdbcCommand Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.1.24431.7

Kaynak:

OdbcCommand.cs

Bir veri kaynağında yürütülecek SQL deyimini veya saklı yordamı temsil eder. Bu sınıf devralınamaz.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Devralma

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnekte ExecuteNonQuerykullanılır.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Açıklamalar

OdbcCommand sınıfı, bir veri kaynağında komut yürütmek için aşağıdaki yöntemleri sağlar:

Madde	Açıklama
ExecuteReader	Satır döndüren komutları yürütür.
ExecuteNonQuery	SQL INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür.
ExecuteScalar	Veritabanından tek bir değer (örneğin, toplama değeri) alır.

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

Komutun yürütülmesi SQL Server önem düzeyi 20 veya daha fazla gibi önemli bir OdbcException neden oluyorsa OdbcConnection kapanabilir. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Oluşturucular

OdbcCommand()	OdbcCommand sınıfının yeni bir örneğini başlatır.
OdbcCommand(String)	sorgu metniyle OdbcCommand sınıfının yeni bir örneğini başlatır.
OdbcCommand(String, OdbcConnection)	OdbcCommand sınıfının yeni bir örneğini sorgu metni ve bir OdbcConnection nesnesiyle başlatır.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	sorgu metni, bir OdbcConnection nesnesi ve Transactionile OdbcCommand sınıfının yeni bir örneğini 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	OdbcCommandbu örneği tarafından kullanılan OdbcConnection 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ş arabirim denetiminde görünür olup olmayacağını belirten bir değer alır veya ayarlar.
Events	Bu Componenteklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Parameters	OdbcParameterCollectionalır.
Site	Component ISite alır veya ayarlar. (Devralındığı yer: Component)
Transaction	OdbcCommand yürütülürken OdbcTransaction alır veya ayarlar.
UpdatedRowSource	Update yönteminin DataRowkomut sonuçlarını nasıl uygulayacağını belirten bir değer alır veya ayarlar.

Yöntemler

Cancel()	OdbcCommandyürütmeyi iptal etmeye çalışır.
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()	OdbcParameter 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(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)
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 OdbcDataReaderoluşturur.
ExecuteReader(CommandBehavior)	CommandText Connectiongönderir ve CommandBehavior değerlerinden birini kullanarak bir OdbcDataReader 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()	IDbDataParameter nesnesinin yeni bir örneğini oluşturur. (Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader()	Connection karşı CommandText yürütür ve bir IDataReaderoluşturur. (Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Connectionüzerinde CommandText yürütür ve CommandBehavior değerlerinden birini kullanarak bir IDataReader oluşturur. (Devralındığı yer: DbCommand)
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.

Ayrıca bkz.

• OdbcDataAdapter
• OdbcConnection
• Komut Yürütmeyi