Método Execute (Comando do ADO)

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

Sintaxe

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Valor retornado

Retorna uma referência de objeto Recordset, um fluxo ou Nothing.

Parâmetros

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

parâmetros
Opcional. Uma Variant matriz de valores de parâmetro usados em conjunto com a cadeia de caracteres de entrada ou fluxo especificado em CommandText ou CommandStream. (Os parâmetros de saída não retornarão valores corretos quando passados neste argumento.)

opções de
Opcional. Um valor Long que indica como o provedor deve avaliar o CommandText ou a propriedade CommandStream do objeto command. Pode ser um valor de máscara de bits feito usando CommandTypeEnum e/ou valores de ExecuteOptionEnum. Por exemplo, você pode usar adCmdText e adExecuteNoRecords em combinação se quiser que o ADO avalie o valor da propriedade CommandText como texto e indique que o comando deve descartar e não retornar nenhum registro que possa ser gerado quando o texto do comando for executado.

Nota

Use o valor ExecuteOptionEnumadExecuteNoRecords para melhorar o desempenho minimizando o processamento interno. Se adExecuteStream tiver sido especificado, as opções adAsyncFetch e adAsynchFetchNonBlocking serão ignoradas. 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 e Requery de um Recordset.

Observações

O uso do método Execute em um objeto command executa a consulta especificada na propriedade CommandText ou propriedade commandstream do objeto.

Os resultados são retornados em uma do Conjunto de Registros (por padrão) ou como um fluxo de informações binárias. Para obter um fluxo binário, especifique adExecuteStream no Optionse, em seguida, forneça um fluxo definindo Command.Properties("Fluxo de Saída"). Um objeto ADO Stream pode ser especificado para receber os resultados ou outro objeto de fluxo, como o objeto de resposta do IIS, pode ser especificado. Se nenhum fluxo tiver sido especificado antes de chamar Executar com adExecuteStream, ocorrerá um erro. A posição do fluxo no retorno de Executar é específica do provedor.

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. Alguns idiomas de aplicativo permitem que você ignore esse valor retornado se nenhum do Recordset for desejado.

Executar gerará um erro se o usuário especificar um valor para CommandStream quando o CommandType for adCmdStoredProc, adCmdTableou adCmdTableDirect.

Se a consulta tiver parâmetros, os valores atuais para os parâmetros do Command objeto serão usados, a menos que você os substitua com valores de parâmetro passados com a chamada Executar. Você pode substituir um subconjunto dos parâmetros omitindo novos valores para alguns dos parâmetros ao chamar o método Execute. A ordem na qual você especifica os parâmetros é a mesma ordem na qual o método os passa. Por exemplo, se houvesse quatro (ou mais) parâmetros e você quisesse passar novos valores apenas para o primeiro e o quarto parâmetros, passaria Array(var1,,,var4) como o argumento parâmetros.

Nota

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

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

Nota

Ao emitir comandos que contêm URLs, aqueles que usam o esquema http invocarão automaticamente o provedor Microsoft OLE DB para publicação na Internet. Para obter mais informações, consulte URLs absolutas e relativas.

Aplica-se a

do objeto de comando (ADO)

Consulte Também

exemplo de métodos Execute, Requery e Clear (VB)
exemplo de métodos Execute, Requery e Clear (VBScript)
exemplo de métodos Execute, Requery e Clear (VC++)
propriedade CommandStream (ADO)
propriedade CommandText (ADO)
commandTypeEnum
método Execute (Conexão ADO)
do evento ExecuteComplete (ADO)