<Completa objetos Command Reference
O método Execute executa a consulta, instrução SQL ou procedimento especificado na propriedade CommandText do objeto de comando.
Os resultados são armazenados em um novo objeto Recordset se é uma consulta de retorno linha. Um objeto Recordset fechado será devolvido se não é uma consulta de retorno linha.
Sintaxe para linha-retornar
Set rs=objcommand.Execute(ra,parameters,options)
Sintaxe para não-linha-retornar
objcommand.Execute ra,parameters,options
| Parâmetro | Descrição |
|---|---|
| ra | Opcional. Retorna o número de registros afetados por uma consulta. Para uma consulta de retorno de linha, use a propriedade RecordCount do objeto Recordset para contar de quantos registros estão no objeto. |
| parameters | Opcional. Os valores dos parâmetros passados com uma instrução SQL. Usado para alterar, actualizar ou inserir novos valores de parâmetros para a coleção de parâmetros. |
| options | Opcional. Define como o provedor deve avaliar a propriedade CommandText. Pode ser um ou mais CommandTypeEnum ou ExecuteOptionEnum valores. O padrão é adCmdUnspecified. |
Exemplo
<%
Set objcommand.CommandText="SELECT * FROM Customers"
objCommand.Execute
%>
or
<%
Set objcommand.CommandText="Customers"
objCommand.Execute(,,adCmdTableDirect)
%>
Valores CommandTypeEnum
| Constante | Valor | Descrição |
|---|---|---|
| adCmdUnspecified | -1 | Não especifica o argumento de tipo de comando. |
| adCmdText | 1 | Avalia CommandText como uma definição textual de um comando ou chamada de procedimento armazenado. |
| adCmdTable | 2 | Avalia CommandText como um nome da tabela cujas colunas são retornados por uma consulta SQL gerado internamente. |
| adCmdStoredProc | 4 | Avalia CommandText como um nome de procedimento armazenado. |
| adCmdUnknown | 8 | Indica que o tipo de comando na propriedade CommandText não é conhecido. |
| adCmdFile | 256 | Avalia CommandText como o nome de um conjunto de registos armazenadas permanentemente arquivo. Usado com apenas Recordset.Open ou Requery. |
| adCmdTableDirect | 512 | Avalia CommandText como um nome da tabela cujas colunas são todos devolvidos. Usado com apenas Recordset.Open ou Requery. Para usar o método Seek, o conjunto de registros deve ser aberto com adCmdTableDirect. Este valor não pode ser combinado com o valor ExecuteOptionEnum adAsyncExecute. |
Valores ExecuteOptionEnum
| Constante | Valor | Descrição |
|---|---|---|
| adOptionUnspecified | -1 | Indica que o comando não é especificado. |
| adAsyncExecute | Indica que o comando deve ser executado de forma assíncrona. Este valor não pode ser combinado com o valor adCmdTableDirect CommandTypeEnum. | |
| adAsyncFetch | Indica que as linhas restantes após a quantidade inicial especificado na propriedade CacheSize devem ser recuperadas de forma assíncrona. | |
| adAsyncFetchNonBlocking | Indica que o segmento principal nunca bloqueia a durante a recuperação. Se a linha solicitada não tiver sido recuperada, a linha atual se move automaticamente para o final do arquivo. Se você abrir um conjunto de registos a partir de um fluxo que contém um conjunto de registos armazenadas permanentemente, adAsyncFetchNonBlocking não terá um efeito; a operação vai ser síncronas e de bloqueio. adAsynchFetchNonBlocking não tem efeito quando a opção adCmdTableDirect é usado para abrir o conjunto de registos. | |
| adExecuteNoRecords | Indica que o texto de comando é um comando ou procedimento armazenado que não retorna linhas (for example, a command that only inserts data) . Se as linhas são recuperadas, elas são descartadas e não retornou. adExecuteNoRecords só pode ser passado como um parâmetro opcional para o comando ou Connection método de execução. | |
| adExecuteStream | Indica que os resultados de uma execução de comando deve ser retornado como um riacho. adExecuteStream só pode ser passado como um parâmetro opcional para o comando método de execução. | |
| adExecuteRecord | Indica que o CommandText é um comando ou procedimento armazenado que retorna uma única linha que deve ser retornado como um objeto Record. |
<Completa objetos Command Reference