IDbCommand Arabirim

Tanım

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ş
Uygulamalar

Ö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

IDbCommand Arabirimi, 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ını sağlar. Komut sınıfları hakkında daha fazla bilgi için bkz. Komut Yürütme.

Bir uygulama doğrudan arabirimin bir örneğini IDbCommand 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şlevsellik eklemek için ek üyeler tanımlaması gerekir. Örneğin, IDbCommand arabirimi yöntemini tanımlar ExecuteNonQuery . Buna karşılık sınıfı SqlCommand 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 Prv biçimde PrvClassname adlandırın. Örneğin, Sql ad alanında System.Data.SqlClient sınıfının ön ekidirSqlCommand.

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 bir 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

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 nasıl yorumlanır olduğunu CommandText 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 nesnesinin Command yürütüldiği işlemi alır veya ayarlar.

UpdatedRowSource

bir yöntemi DbDataAdaptertarafından kullanıldığında komut sonuçlarının DataRow uygulamasına Update(DataSet) nasıl uygulanacağını alır veya ayarlar.

Yöntemler

Cancel()

bir IDbCommandyürütmesini iptal etmeye çalışır.

CreateParameter()

Nesnenin yeni bir IDbDataParameter ö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: IDisposable)
ExecuteNonQuery()

Bir .NET veri sağlayıcısının nesnesine Connection karşı bir SQL deyimi yürütür ve etkilenen satır sayısını döndürür.

ExecuteReader()

üzerinde Connection öğesini CommandText yürütür ve bir IDataReaderoluşturur.

ExecuteReader(CommandBehavior)

üzerinde komutunu CommandTextConnectionyürütür ve değerlerden CommandBehavior birini kullanarak bir IDataReader 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.

Şunlara uygulanır

Ayrıca bkz.