OleDbCommand.ExecuteNonQuery Método

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

Executa uma instrução SQL contra o Connection e devolve 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

Devoluções

Int32

O número de linhas afetadas.

Implementações

ExecuteNonQuery()

Exceções

InvalidOperationException

A ligação não existe.

-ou-

A ligação não está aberta.

-ou-

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

Exemplos

O exemplo seguinte cria um OleDbCommand e depois executa-o usando ExecuteNonQuery. O exemplo recebe uma string que é uma instrução SQL como UPDATE, INSERT ou DELETE, e uma string para usar para se ligar à 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

Observações

Pode usar o ExecuteNonQuery para realizar operações de catálogo, por exemplo, para consultar a estrutura de uma base de dados ou para criar objetos de base de dados como tabelas, ou para alterar os dados numa base de dados sem usar um DataSet , executando instruções UPDATE, INSERT ou DELETE.

Embora não ExecuteNonQuery retorne linhas, quaisquer parâmetros de saída ou valores de retorno mapeados para parâmetros são preenchidos com dados.

Para as instruções UPDATE, INSERT e DELETE, o valor de retorno é o número de linhas afetadas pelo comando. Para todos os outros tipos de sentenças, o valor de retorno é -1. Se ocorrer um rollback, o valor de retorno também é -1.

Aplica-se a

Ver também