OleDbCommand.ExecuteNonQuery Método

Definição

Namespace:
System.Data.OleDb
Assembly:
System.Data.dll

Executa uma instrução Connection SQL e retorna o número de linhas afetadas.

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

Retornos

Int32

O número de linhas afetadas.

Implementações

ExecuteNonQuery()

Exceções

InvalidOperationException

A conexão não existe.

-ou-

A conexão não está aberta.

-ou-

Não é possível executar um comando em um contexto de transação que difere do contexto em que a conexão foi inserida originalmente.

Exemplos

O exemplo a seguir cria um OleDbCommand e o executa usando 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.

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 as ExecuteNonQuery operações de catálogo para executar, 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 de dados sem usar uma DataSet executando instruções UPDATE, INSERT ou DELETE.

Embora as ExecuteNonQuery linhas não retornem, os parâmetros de saída ou valores retornados mapeados para parâmetros são preenchidos com dados.

Para instruções UPDATE, INSERT e DELETE, o valor retornado é o número de linhas afetadas pelo comando. Para todos os outros tipos de instruções, o valor retornado é -1. Se ocorrer uma reversão, o valor retornado também será -1.

Aplica-se a

Confira também