OleDbCommand.ExecuteNonQuery Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Data.OleDb
Bütünleştirilmiş Kod:
System.Data.OleDb.dll
Bütünleştirilmiş Kod:
System.Data.dll
Paket:
System.Data.OleDb v8.0.1
Paket:
System.Data.OleDb v9.0.0-rc.2.24473.5
Kaynak:
OleDbCommand.cs
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:
 virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public 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.

Şunlara uygulanır

Ayrıca bkz.