IDbCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Spustí příkaz SQL proti objektu Connection zprostředkovatele dat .NET a vrátí počet ovlivněných řádků.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Návraty

Int32

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

Výjimky

InvalidOperationException

Připojení neexistuje.

-nebo-

Připojení není otevřené.

Příklady

Následující příklad vytvoří instanci odvozené třídy OleDbCommanda pak ji spustí. Za tímto účelem se metodě předá řetězec, který je příkazem SQL SELECT, a řetězec, který se použije 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 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í DataSet příkazů UPDATE, INSERT nebo DELETE.

I když objekt 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 všechny ostatní typy příkazů je návratová hodnota -1.