OleDbCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.OleDb.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.OleDb v11.0.0-preview.4.26230.115
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs

Provede příkaz SQL na Connection základě a vrátí počet ovlivněnýchřádkůch

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

Návraty

Int32

Počet ovlivněných řádků

Implementuje

ExecuteNonQuery()

Výjimky

InvalidOperationException

Připojení neexistuje.

nebo

Připojení není otevřené.

nebo

Nelze spustit příkaz v kontextu transakce, který se liší od kontextu, ve kterém bylo připojení původně zařazeno.

Příklady

Následující příklad vytvoří OleDbCommand a pak ho spustí pomocí ExecuteNonQuery. Příklad se předá řetězci, který je příkazem SQL, jako je UPDATE, INSERT nebo DELETE, a řetězec, který se má použít pro připojení ke zdroji dat.

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

Poznámky

Můžete použít ExecuteNonQuery k provádění operací katalogu, například k dotazování struktury databáze nebo k vytvoření databázových objektů, jako jsou tabulky, nebo ke změně dat v databázi bez použití DataSet příkazu UPDATE, INSERT nebo DELETE.

ExecuteNonQuery Přestože se nevrátí žádné řádky, žádné výstupní parametry nebo návratové hodnoty mapované na parametry se naplní daty.

U příkazů UPDATE, INSERT a DELETE je vrácená hodnota počet řádků ovlivněných příkazem. U všech ostatních typů příkazů je návratová hodnota -1. Pokud dojde ke zpětnému vrácení zpět, návratová hodnota je také -1.

Platí pro

Viz také