Método Execute (conexão ADO)

Executa a consulta, a instrução SQL, o procedimento armazenado especificado ou o texto específico do provedor.

Sintaxe

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

Valor retornado

Retorna uma referência de objeto Recordset Object (ADO).

Parâmetros

CommandText
Um valor String que contém a instrução SQL, o procedimento armazenado, uma URL ou um texto específico do provedor a ser executado. Opcionalmente, os nomes de tabela podem ser usados, mas somente se o provedor estiver ciente do SQL. Por exemplo, se um nome de tabela "Customers" for usado, o ADO anexará automaticamente a sintaxe padrão do SQL Select para formar e transmitir "SELECT * FROM Customers" como uma instrução Transact-SQL ao provedor.

RecordsAffected
Opcional. Uma variável Long para a qual o provedor retorna o número de registros que a operação afetou.

Opções
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 Use o valor ExecuteOptionEnumadExecuteNoRecords para melhorar o desempenho minimizando o processamento interno e para aplicativos que você está portando do Visual Basic 6.0.

Não use adExecuteStream com o método Execute de um objeto Connection.

Não use os valores CommandTypeEnum de adCmdFile ou adCmdTableDirect com Execute. Esses valores só podem ser usados como opções com os métodos Open Method (ADO Recordset) e Requery Method de um Recordset.

Comentários

Usar o método Execute em um objeto Connection Object (ADO) executará qualquer consulta que você transmitir ao método no argumento CommandText na conexão especificada. Se o argumento CommandText especificar uma consulta de retorno de linha, todos os resultados gerados pela execução serão armazenados em um novo objeto Recordset. Se o comando não se destinar a retornar resultados (por exemplo, uma consulta SQL UPDATE) o provedor retornará Nothing desde que a opção adExecuteNoRecords seja especificada. Caso contrário, Execute retornará um Recordset fechado.

O objeto Recordset retornado é sempre um cursor somente leitura, somente para frente. Se você precisar de um objeto Recordset com mais funcionalidade, primeiro crie um objeto Recordset com as configurações de propriedade desejadas e use o método Open Method (ADO Recordset) do objeto Recordset para executar a consulta e retornar o tipo de cursor desejado.

O conteúdo do argumento CommandText é específico para o provedor e pode ser uma sintaxe SQL padrão ou qualquer formato de comando especial compatível com o provedor.

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

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

Aplica-se A

Objeto Connection (ADO)