<Completa Recordset Object Reference
O método Open abre um elemento de base de dados que lhe dá acesso a registros em uma tabela, os resultados de uma consulta, ou para um conjunto de registros salvos.
Tip: Sempre feche o objecto Recordset após usá-lo, para liberar recursos do sistema. Defina o objeto Recordset para Nada a eliminá-lo completamente da memória.
Sintaxe
objRecordset.Open source,actconn,cursortyp,locktyp,opt
| Parâmetro | Descrição |
|---|
| source | Opcional. Especifica uma fonte de dados. O parâmetro de origem pode ser um dos seguintes procedimentos: - A URL
- A / nome de caminho completo do arquivo relativo
- Um objeto Command
- Uma instrução SQL
- Um procedimento armazenado
- Um nome de tabela
|
| actconn | Opcional. Uma cadeia de conexão ou um objeto Connection |
| cursortyp | Opcional. Um CursorTypeEnum valor que especifica o tipo de cursor para utilizar quando se abre um objecto de registos. O padrão é adOpenForwardOnly |
| locktyp | Opcional. Um LockTypeEnum valor que especifica o tipo de bloqueio sobre um objecto de registos. O padrão é adLockReadOnly |
| opt | Opcional. Especifica a forma de avaliar o parâmetro de origem se ele não é um objeto de comando. Pode ser um ou mais CommandTypeEnum ou ExecuteOptionEnum valores. |
Exemplo
Open an ADO Table Recordset:
<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "Customers", conn
%>
Open an ADO SQL Recordset:
<%
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs = Server.CreateObject("ADODB.recordset")
rs.Open "Select * from Customers", conn
%>
Valores CursorTypeEnum
| Constante | Valor | Descrição |
|---|
| adOpenUnspecified | -1 | tipo não especificado de cursor |
| adOpenForwardOnly | 0 | Padrão. Um cursor somente para a frente. Isso melhora o desempenho quando você precisa fazer apenas uma passagem através de um conjunto de registos |
| adOpenKeyset | 1 | Um cursor de conjunto de chaves. Como um cursor dinâmico, exceto que você não pode ver registros que outros usuários adicionar, embora os registros que outros usuários excluir são inacessíveis a partir do seu conjunto de registos. As alterações de dados por outros usuários ainda são visíveis. |
| adOpenDynamic | 2 | Um cursor dinâmico. Adições, modificações, eliminações e por outros utilizadores são visíveis, e são permitidos de todos os tipos de movimento através do conjunto de registos |
| adOpenStatic | 3 | Um cursor estático. Uma cópia estática de um conjunto de registros que você pode usar para localizar dados ou gerar relatórios. Adições, alterações ou supressões por outros usuários não são visíveis. |
Valores LockTypeEnum
| Constante | Valor | Descrição |
|---|
| adLockUnspecified | -1 | tipo não especificado de bloqueio. Clones herda tipo de bloqueio do conjunto de registros originais. |
| adLockReadOnly | 1 | Padrão. Somente leitura registros |
| adLockPessimistic | 2 | bloqueio pessimista, ficha por ficha. Os registros de bloqueio provedor imediatamente após a edição |
| adLockOptimistic | 3 | travamento optimista, ficha por ficha. Os registros de bloqueio provedor só ao chamar atualização |
| adLockBatchOptimistic | 4 | atualizações em lote otimista. Necessário para modo de atualização em lote |
Valores CommandTypeEnum
| Constante | Valor | Descrição |
|---|
| adCmdUnspecified | -1 | tipo não especificado 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 |
| adCmdStoredProc | 4 | Avalia CommandText como um nome de procedimento armazenado |
| adCmdUnknown | 8 | Padrão. tipo desconhecido de comando |
| 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. Não pode ser combinado com o valor ExecuteOptionEnum adAsyncExecute. |
Valores ExecuteOptionEnum
| Constante | Valor | Descrição |
|---|
| adOptionUnspecified | -1 | comando não especificado |
| adAsyncExecute | 16 | O comando deve ser executado de forma assíncrona. Não pode ser combinado com o valor CommandTypeEnum adCmdTableDirect |
| adAsyncFetch | 32 | As restantes linhas após a quantidade inicial especificado na propriedade CacheSize devem ser recuperadas de forma assíncrona |
| adAsyncFetchNonBlocking | 64 | O thread principal não bloqueia 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 | 128 | O texto de comando é um comando ou procedimento armazenado que não retorna linhas. 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 execute |
| adExecuteStream | 256 | 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 | 512 | O CommandText é um comando ou procedimento armazenado que retorna uma única linha que deve ser retornado como um objeto de registro |
<Completa Recordset Object Reference