OleDbCommand.ExecuteNonQuery Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa uma instrução SQL no Connection e retorna o número de linhas afetadas.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerRetornos
O número de linhas afetadas.
Implementações
Exceções
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 diferente do contexto no qual a conexão foi inscrita 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 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 de dados sem usar um DataSet executando instruções UPDATE, INSERT ou DELETE.
Embora o ExecuteNonQuery não retorne linhas, quaisquer 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.
