OracleCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Návraty

Int32

U příkazů UPDATE, INSERT a DELETE je návratovou hodnotou počet řádků ovlivněných příkazem. Pro příkazy CREATE TABLE a DROP TABLE je vrácená hodnota 0. Pro všechny ostatní typy příkazů je návratová hodnota -1.

Výjimky

InvalidOperationException

Připojení neexistuje.

-nebo-

Připojení není otevřené.

Příklady

Následující příklad vytvoří OracleCommand objekt a pak ho spustí pomocí ExecuteNonQuerypříkazu . Příklad je předán řetězec, který je příkazem SQL (například UPDATE, INSERT nebo DELETE), a řetězec pro připojení k databázi.

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Poznámky

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

I když ExecuteNonQuery nevrací žádné řádky, všechny výstupní parametry nebo návratové hodnoty mapované na parametry se naplní daty.

U příkazů UPDATE, INSERT a DELETE je návratovou hodnotou počet řádků ovlivněných příkazem. Pro příkazy CREATE TABLE a DROP TABLE je vrácená hodnota 0. Pro všechny ostatní typy příkazů je návratová hodnota -1. Pokud dojde k vrácení zpět, je vrácená hodnota také -1.

Viz také

• Práce s příkazy