OleDbCommand.ExecuteNonQuery Yöntem

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Kaynak:

OleDbCommand.cs

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Döndürülenler

Int32

Etkilenen satır sayısı.

Uygulamalar

ExecuteNonQuery()

Özel durumlar

InvalidOperationException

Bağlantı yok.

-veya-

Bağlantı açık değil.

-veya-

Bağlantının ilk olarak listelendiği bağlamdan farklı bir işlem bağlamında komut yürütülemez.

Örnekler

Aşağıdaki örnek bir OleDbCommand oluşturur ve kullanarak ExecuteNonQueryyürütür. Örnek, UPDATE, INSERT veya DELETE gibi bir SQL deyimi olan bir dizeye ve veri kaynağına bağlanmak için kullanılacak bir dizeye geçirilir.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

Açıklamalar

Örneğin, bir veritabanının yapısını sorgulamak veya tablolar gibi veritabanı nesneleri oluşturmak ya da UPDATE, INSERT veya DELETE deyimlerini yürüterek veritabanındaki DataSet verileri değiştirme gibi katalog işlemleri gerçekleştirmek için kullanabilirsinizExecuteNonQuery.

hiçbir satır döndürmese ExecuteNonQuery de, parametrelerle eşlenen tüm çıkış parametreleri veya dönüş değerleri verilerle doldurulur.

UPDATE, INSERT ve DELETE deyimleri için dönüş değeri, komutundan etkilenen satır sayısıdır. Diğer tüm deyim türleri için dönüş değeri -1'dir. Geri alma gerçekleşirse, dönüş değeri de -1 olur.

Ayrıca bkz.

• Komutlarla Çalışma