IDbCommand.ExecuteNonQuery Método

Definição

Executa uma instrução SQL no objeto Connection de um provedor de dados .NET e retorna o número de linhas afetadas.Executes an SQL statement against the Connection object of a .NET data provider, and returns the number of rows affected.

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

Retornos

Int32

O número de linhas afetadas.The number of rows affected.

Exceções

A conexão não existe.The connection does not exist.

- ou --or-

A conexão não está aberta.The connection is not open.

Exemplos

O exemplo a seguir cria uma instância da classe derivada, OleDbCommand e, em seguida, a executa.The following example creates an instance of the derived class, OleDbCommand, and then executes it. Para fazer isso, o método é passado uma cadeia de caracteres que é uma instrução SQL SELECT e uma cadeia de caracteres a ser usada para se conectar à fonte de dados.To accomplish this, the method is passed a string that is a SQL SELECT statement and a string to use to connect to the data source.

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

Comentários

Você pode usar o ExecuteNonQuery para executar operações de catálogo (por exemplo, consultar a estrutura de um banco de dados ou criar objetos de banco de dados, como tabelas), ou para alterar o dado em um banco sem usar um DataSet executando as instruções UPDATE, INSERT ou Delete.You can use the ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database without using a DataSet by executing UPDATE, INSERT, or DELETE statements.

Embora o ExecuteNonQuery não retorne nenhuma linha, todos os parâmetros de saída ou valores de retorno mapeados para parâmetros são preenchidos com dados.Although the ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data.

Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Para todos os outros tipos de instruções, o valor retornado é -1.For all other types of statements, the return value is -1.

Aplica-se a