<Completa Connection Object Reference
O método Execute executa uma consulta especificado, instrução SQL, procedimento armazenado ou texto específico do provedor.
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.
Note: O conjunto de registros retornado é sempre um read-only, somente de encaminhamento de registros!
Tip: Para criar um conjunto de registos com mais funcionalidades, primeiro criar um objeto Recordset. Definir as propriedades desejadas, e, em seguida, usar o método aberto do objecto de registos para executar a consulta.
Sintaxe para linha-retornar
Set objrs=objconn.Execute(commandtext,ra,options)
Sintaxe para não-linha-retornar
objconn.Execute commandtext,ra,options
| Parâmetro | Descrição |
|---|---|
| commandtext | Requeridos. A instrução SQL, procedimento armazenado ou texto específico do provedor para executar |
| ra | Opcional. O número de registros afetados pela consulta |
| options | Opcional. Define como o provedor deve avaliar o parâmetro CommandText. Pode ser um ou mais CommandTypeEnum ou ExecuteOptionEnum valores. Padrão é adCmdUnspecified |
Exemplo
<%
sql="SELECT companyname FROM Customers"
Set rs=conn.Execute(sql)
%>
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 Connection Object Reference