IDbCommand Arabirim

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.dll

Bir veri kaynağına bağlıyken yürütülen ve ilişkisel veritabanlarına erişen .NET veri sağlayıcıları tarafından uygulanan bir SQL deyimini temsil eder.

public interface class IDbCommand : IDisposable

public interface IDbCommand : IDisposable

type IDbCommand = interface
    interface IDisposable

Public Interface IDbCommand
Implements IDisposable

Türetilmiş

System.Data.Common.DbCommand

System.Data.OleDb.OleDbCommand

Uygulamalar

IDisposable

Örnekler

Aşağıdaki örnek, SqlConnection, SqlCommandve SqlDataReadertüretilmiş sınıfların örneklerini oluşturur. Örnek, verileri okuyup konsola yazar. Son olarak, örnek öğesini ve ardından öğesini SqlConnectionkapatırSqlDataReader.

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Açıklamalar

arabirimi, IDbCommand devralan bir sınıfın bir veri kaynağında yürütülen bir SQL deyimini temsil eden bir Command sınıfı uygulamasına olanak tanır. Komut sınıfları hakkında daha fazla bilgi için bkz. Komut Yürütme.

Bir uygulama doğrudan arabirimin IDbCommand bir örneğini oluşturmaz, ancak arabirimi uygulayan bir sınıfın örneğini IDbCommand oluşturur.

Uygulayan IDbCommand sınıfların tüm üyelerini uygulaması ve genellikle sağlayıcıya özgü işlevler eklemek için ek üyeler tanımlaması gerekir. Örneğin, IDbCommand arabirimi yöntemini tanımlar ExecuteNonQuery . Buna karşılık, SqlCommand sınıfı bu yöntemi devralır ve yöntemini de tanımlar ExecuteXmlReader .

Uygulayanlara Notlar

.NET Framework veri sağlayıcıları arasında tutarlılığı artırmak için devralan sınıfı, belirli bir .NET Framework veri sağlayıcısı ad alanında tüm sınıflara verilen tekdüzen ön ek olduğu biçimde PrvClassnamePrv adlandırın. Örneğin, Sql ad alanında SqlCommand sınıfının ön ekidirSystem.Data.SqlClient.

Arabiriminden IDbCommand devraldığınızda aşağıdaki oluşturucuları uygulamanız gerekir:

Öğe	Açıklama
PrvCommand()	PrvCommand sınıfının yeni bir örneğini başlatır.
PrvCommand(dize cmdText)	Sorgu metniyle PrvCommand sınıfının yeni bir örneğini başlatır.
PrvCommand(dize cmdText, PrvConnection bağlantısı)	Sorgu metni ve PrvConnection ile PrvCommand sınıfının yeni bir örneğini başlatır.
PrvCommand(dize cmdText, PrvConnection bağlantısı, PrvTransaction işlemi)	Sorgu metni, PrvConnection ve PrvTransaction ile PrvCommand sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
CommandText	Veri kaynağında çalıştırılacak metin komutunu 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 CommandText nasıl yorumlanmış olduğunu gösterir veya belirtir.
Connection	öğesinin IDbConnection bu örneği tarafından kullanılan öğesini IDbCommandalır veya ayarlar.
Parameters	IDataParameterCollection öğesini alır.
Transaction	bir .NET veri sağlayıcısının Command nesnesinin yürütüldiği işlemi alır veya ayarlar.
UpdatedRowSource	komut sonuçlarının yöntemi DbDataAdaptertarafından Update(DataSet) kullanıldığında öğesine DataRow nasıl uygulanacağını alır veya ayarlar.

Yöntemler

Name	Description
Cancel()	Bir IDbCommandyürütmeyi iptal etmeye çalışır.
CreateParameter()	Nesnenin yeni bir IDbDataParameter ö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: IDisposable)
ExecuteNonQuery()	.NET veri sağlayıcısının Connection nesnesine karşı bir SQL deyimi yürütür ve etkilenen satır sayısını döndürür.
ExecuteReader()	üzerinde CommandText komutunu Connection yürütür ve bir IDataReaderoluşturur.
ExecuteReader(CommandBehavior)	üzerinde komutunu CommandTextConnectionyürütür ve değerlerden birini IDataReader kullanarak bir CommandBehavior oluşturur.
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.
Prepare()	Veri kaynağında komutun hazırlanmış (veya derlenmiş) bir sürümünü oluşturur.

Ayrıca bkz.

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand