Método Execute (conexão do ADO)
Aplica-se ao: Access 2013 | Access 2016
Executa a consulta, a instrução SQL, o procedimento armazenado ou o texto específico do provedor especificado.
Sintaxe
For a non-row-returning command string:
ligação. ExecutarCommandText, RecordsAffected, Options
For a row-returning command string:
Definirligação de conjunto = deregistos.Execute( CommandText, RecordsAffected, Options )
Valor de retorno
Retorna uma referência do objeto Recordset.
Parâmetros
CommandText
- A String value that contains the SQL statement, stored procedure, a URL, or provider-specific text to execute. Optionally, table names can be used but only if the provider is SQL aware. For example if a table name of "Customers" is used, ADO will automatically prepend the standard SQL Select syntax to form and pass "SELECT * FROM Customers" as a T-SQL statement to the provider.
Registos Afetados
- Optional. A Long variable to which the provider returns the number of records that the operation affected.
Options
- Opcional. Um valor Long que indica como o provedor deve avaliar o argumento CommandText. Pode ser uma máscara de bits de um ou mais valores CommandTypeEnum ou ExecuteOptionEnum.
Observação
[!OBSERVAçãO] Use the ExecuteOptionEnum value adExecuteNoRecords to improve performance by minimizing internal processing.
Do not use the CommandTypeEnum values of adCmdFile or adCmdTableDirect with Execute. Esses valores podem ser utilizados apenas como opções com os métodos Open e Requery de um Recordset.
Comentários
A utilização do método Execute em um objeto Connection executa qualquer consulta passada ao método no argumento CommandText na conexão especificada. Se o argumento CommandText especificar uma consulta que retorne linhas, quaisquer resultados gerados pela execução serão armazenados em um novo objeto Recordset. Se o comando não se destinar a devolver resultados (por exemplo, uma consulta SQL UPDATE), o fornecedor devolve Nada desde que a opção adExecuteNoRecords seja especificada; caso contrário, Executar devolve um Conjunto de Registos fechado.
O objeto Recordset retornado é sempre um cursor somente leitura e somente de encaminhamento. Se você precisar de um objeto Recordset com mais funcionalidade, primeiro crie um objeto Recordset com as definições de propriedade desejadas e, em seguida, utilize o método Open do objeto Recordset para executar a consulta e retornar o tipo de cursor desejado.
O conteúdo do argumento CommandText é específico do provedor e pode ser uma sintaxe SQL padrão ou qualquer formato especial de comando que o provedor suporte.
Um evento ExecuteComplete será emitido quando essa operação for concluída.
Observação
[!OBSERVAçãO] URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. For more information, see Absolute and Relative URLs.
Confira também
- Fórum do Access para desenvolvedores
- Ajuda do Access em support.office.com
- Ajuda do Access em answers.microsoft.com
- Fóruns do Access no UtterAccess
- Central de ajuda da programação VBA e desenvolvedor do Access (FMS)
- Postagens do Access no StackOverflow
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.