Compartilhar via

Método Execute (comando do ADO)

  • Artigo

Aplica-se ao: Access 2013 | Access 2016

Executa a consulta, a instrução SQL ou o procedimento armazenado especificado na propriedade CommandText.

Sintaxe

For a Recordset -returning Command:

For a non-recordset-returning Command:

Valor de retorno

Retorna uma referência ao objeto Recordset ou Nothing.

Parâmetros

  • Recordsaffected

    • Optional. Uma variável Long para a qual o provedor retorna o número de registros que a operação afetou. O parâmetro RecordsAffected é aplicado apenas para procedimentos armazenados ou consultas de ação. RecordsAffected não retorna o número de registros retornados por um procedimento armazenado ou uma consulta que retorna resultados. Para obter essas informações, utilize a propriedade RecordCount. O método Execute não retornará as informações corretas quando utilizando com adAsyncExecute, simplesmente porque quando um comando é executado de forma assíncrona, o número de registros afetados pode ainda não ser conhecido no momento que o método retorna.

  • Parameters

    • Optional. A Variant array of parameter values passed with an SQL statement. (Output parameters will not return correct values when passed in this argument.)

  • Options

    • Opcional. Um valor Long que indica como o provedor deve avaliar a propriedade CommandText do objeto Command. Pode ser um valor de máscara de bits gerado utilizando valores CommandTypeEnum e/ou ExecuteOptionEnum. Por exemplo, você poderia utilizar adCmdText e adExecuteNoRecords combinados se deseja que o ADO avalie o valor da propriedade CommandText como texto e indicar que o comando deve descartar e não retornar registro algum que possa ser gerado quando o texto do comando é executado.

Comentários

Using the Execute method on a Command object executes the query specified in the CommandText property of the object. If the CommandText property specifies a row-returning query, any results that the execution generates are stored in a new Recordset object. If the command is not a row-returning query, the provider returns a closed Recordset object. Some application languages allow you to ignore this return value if no Recordset is desired.

If the query has parameters, the current values for the Command object's parameters are used unless you override these with parameter values passed with the Execute call. You can override a subset of the parameters by omitting new values for some of the parameters when calling the Execute method. The order in which you specify the parameters is the same order in which the method passes them. Por exemplo, se houvesse quatro (ou mais) parâmetros e você quisesse passar novos valores apenas para o primeiro e quarto parâmetros, você passaria como o argumento Parâmetros .

Observação

Os parâmetros de saída não retornarão valores corretos quando passados no argumento Parameters.

Um evento ExecuteComplete será emitido quando essa operação for concluída.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.