OleDbCommand.ExecuteNonQuery Método

Definição

Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.Executes an SQL statement against the Connection and returns the number of rows affected.

public:
 virtual int ExecuteNonQuery();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

Retornos

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

Implementações

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.

- ou --or-

Não é possível executar um comando em um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Exemplos

O exemplo a seguir cria um OleDbCommand e, em seguida, executa-o usando ExecuteNonQuery.The following example creates an OleDbCommand and then executes it using ExecuteNonQuery. O exemplo é passado uma cadeia de caracteres que é uma instrução SQL, como UPDATE, INSERT ou DELETE, e uma cadeia de caracteres a ser usada para se conectar à fonte de dados.The example is passed a string that is an SQL statement such as UPDATE, INSERT, or DELETE, 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, para consultar a estrutura de um banco de dados ou para criar objetos de banco de dados, como tabelas, ou para alterar os dados em um banco sem usar um DataSet executando UPDATE, INSERT ou excluir instruções.You can use the ExecuteNonQuery to perform catalog operations, for example, to query the structure of a database or to create 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 returns no 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. Se ocorrer uma reversão, o valor de retorno também será-1.If a rollback occurs, the return value is also -1.

Aplica-se a

Veja também