Método Execute (Conexão ADO)

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

Sintaxe

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

Valor de retorno

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

Parâmetros

CommandText
Um valor de cadeia de caracteres 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 de "Clientes" for usado, o ADO anexará automaticamente a sintaxe sql select padrão para formar e passar "SELECT * FROM Customers" como uma instrução Transact-SQL para o provedor.

RecordsAffected
Opcional. Uma variável Long à qual o provedor retorna o número de registros afetados pela operação.

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 .

Nota 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.

Observações

O uso do método Execute em um objeto ADO (Objeto de Conexão) executa qualquer consulta que você passar para o 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 tiver a intenção de 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 de conjunto de registrosfechado.

O objeto Recordset retornado é sempre um cursor somente leitura e somente encaminhamento. 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 esta operação for concluída.

Aplica-se a

Objeto de Conexão (ADO)