IDbCommand.ExecuteNonQuery Método

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Devoluções

O número de linhas afetadas.

Exceções

Exemplos

O exemplo seguinte cria uma instância da classe derivada, OleDbCommand, e depois executa-a. Para isso, o método recebe uma string que é uma instrução SQL SELECT 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, consultar a estrutura de uma base de dados ou criar objetos de base de dados como tabelas), ou para alterar os dados numa base de dados sem usar um DataSet ao executar instruções UPDATE, INSERT ou DELETE.

Embora não ExecuteNonQuery devolva 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.