IDbCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDbCommand.cs

Spustí příkaz SQL na 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í. K tomu je metoda předán řetězec, který je příkaz SQL SELECT 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 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říkazu UPDATE, INSERT nebo DELETE.

ExecuteNonQuery Přestože nevrací žádné řádky, žádné výstupní parametry nebo návratové hodnoty mapované na parametry jsou naplněny 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.