OdbcCommand Sınıf

Başvuru

Tanım

Ad Alanı:: System.Data.Odbc

Bütünleştirilmiş Kod:: System.Data.Odbc.dll

Bütünleştirilmiş Kod:: System.Data.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

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

public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

type OdbcCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable

Devralma: Object

DbCommand
OdbcCommand

Devralma: Object

MarshalByRefObject

Component

DbCommand
OdbcCommand

Devralma: Object

MarshalByRefObject

Component
OdbcCommand

Uygulamalar: ICloneable IDbCommand IDisposable

Örnekler

Aşağıdaki örnekte kullanılır ExecuteNonQuery.

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

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

Öğe	Açıklama
ExecuteReader	Satırları 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, bir toplama değeri) alır.

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

Komutun yürütülmesi, SQL Server önem düzeyi 20 veya daha fazla gibi önemli OdbcException bir öğeye neden olursa kapatılabilirOdbcConnection. 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 sınıfının yeni bir örneğini OdbcCommand başlatır.
OdbcCommand(String, OdbcConnection)	Sorgu metni ve bir nesne ile sınıfının yeni bir OdbcConnection örneğini OdbcCommand başlatır.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	sorgu metni OdbcCommand , bir nesnesi ve ile sınıfının yeni bir OdbcConnection örneğini Transactionbaşlatır.

Özellikler

CanRaiseEvents	Bileşenin bir 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 OdbcConnection bu örneği tarafından kullanılan öğesini OdbcCommandalı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 öğesini 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ş arabirim 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	OdbcParameterCollection öğesini alır.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
Transaction	yürütülürken içindeki öğesini OdbcCommand alır veya ayarlarOdbcTransaction.
UpdatedRowSource	Update yönteminin DataRow'a komut sonuçlarını nasıl uygulayacağını belirten bir değer alır veya ayarlar.

Yöntemler

Cancel()	yürütmesini OdbcCommandiptal etmeye çalışır.
CreateDbParameter()	Bir 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 OdbcParameter ö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 solüste eder. (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ına göre 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öntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, iptal edilmiş bir iptal belirteci geçirilirse 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 iptalini istemek 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öntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, iptal edilmiş bir iptal belirteci geçirilirse 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 CommandText Connection gönderir ve bir OdbcDataReaderoluşturur.
ExecuteReader(CommandBehavior)	CommandText öğesine Connectiongönderir ve değerlerden birini `CommandBehavior` kullanarak bir OdbcDataReader 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()	Kullanımdan kalktı. 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 Component Containersağ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()	Kullanımdan kalktı. 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()	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 API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. üzerinde Connection öğesini CommandText yürütür ve bir IDataReaderoluşturur.
IDbCommand.ExecuteReader()	üzerinde Connection öğesini CommandText yürütür ve bir IDataReaderoluşturur. (Devralındığı yer: DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. üzerinde öğesini CommandText Connectionyürütür ve belirtilen davranışı kullanarak bir IDataReader oluşturur.
IDbCommand.ExecuteReader(CommandBehavior)	üzerinde komutunu CommandText Connectionyürütür ve değerlerden CommandBehavior birini kullanarak bir IDataReader oluşturur. (Devralındığı yer: DbCommand)
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