Exemplos
GetRows
Este exemplo demonstra como usar o método GetRows.
Recordset objeto
O objeto ADO Recordset é usado para manter um conjunto de registros de uma tabela de banco de dados. Um objecto de registos consistem de discos e colunas (fields) .
No ADO, este objecto é o mais importante e o usado mais frequentemente para manipular os dados a partir de um banco de dados.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Quando você abre um conjunto de registos, o ponteiro do registro atual irá apontar para o primeiro registro e do BOF e propriedades EOF são falsas. Se não há registros, o BOF e EOF propriedades são True.
objetos Recordset pode suportar dois tipos de atualização:
- Immediate updating - todas as alterações são gravadas imediatamente para o banco de dados uma vez que você chamar o método Update.
- Batch updating - o provedor irá armazenar em cache várias alterações e, em seguida, enviá-los para o banco de dados com o método UpdateBatch.
No ADO existem 4 tipos diferentes de cursor definidos:
- Dynamic cursor - Permite ver as adições, alterações e exclusões por outros usuários.
- Keyset cursor - Como um cursor dinâmico, exceto que você não pode ver adições por outros usuários, e impede o acesso a registros que outros usuários foram excluídos. As alterações de dados por outros usuários ainda será visível.
- Static cursor - Fornece uma cópia estática de um conjunto de registros para você usar para localizar dados ou gerar relatórios. Adições, alterações ou supressões por outros usuários não serão visíveis. Este é o único tipo de cursor permitido quando você abre um objeto Recordset do lado do cliente.
- Forward-only cursor - Permite que você só para se deslocar para a frente através de registos. Adições, alterações ou supressões por outros usuários não serão visíveis.
O tipo de cursor pode ser definido pela propriedade CursorType ou pelo parâmetro CursorType no método Open.
Note: Nem todos os provedores de suportar todos os métodos ou propriedades do objeto Recordset.
propriedades
| Propriedade | Descrição |
|---|---|
| AbsolutePage | Define ou retorna um valor que especifica o número da página no objeto Recordset |
| AbsolutePosition | Define ou retorna um valor que especifica a posição ordinal do registro atual no objeto Recordset |
| ActiveCommand | Retorna o objeto de comando associado com o conjunto de registos |
| ActiveConnection | Define ou retorna uma definição para uma conexão se a conexão é fechada, ou o objeto de conexão atual, se a conexão está aberta |
| BOF | Retorna true se a posição do registro atual é antes do primeiro registro, caso contrário false |
| Bookmark | Define ou retorna um marcador. O marcador salva a posição do registro atual |
| CacheSize | Define ou retorna o número de registros que podem ser armazenados em cache |
| CursorLocation | Define ou retorna a localização do serviço de cursor |
| CursorType | Define ou retorna o tipo de cursor de um objeto Recordset |
| DataMember | Define ou retorna o nome do membro de dados que será recuperada do objeto referenciado pela propriedade DataSource |
| DataSource | Especifica um objecto contendo dados a serem representados como um objecto de registos |
| EditMode | Retorna o status edição do registro atual |
| EOF | Retorna true se a posição do registro atual é após o último registro, caso contrário false |
| Filter | Define ou retorna um filtro para os dados de um objecto de registos |
| Index | Define ou retorna o nome do índice atual para um objeto Recordset |
| LockType | Define ou retorna um valor que especifica o tipo de dispositivo de bloqueio, quando a edição de uma ficha em um conjunto de registos |
| MarshalOptions | Define ou retorna um valor que especifica quais registros devem ser devolvidos ao servidor |
| MaxRecords | Define ou retorna o número máximo de registros para retornar a um objeto Recordset de uma consulta |
| PageCount | Retorna o número de páginas com dados em um objeto Recordset |
| PageSize | Define ou retorna o número máximo de registros permitidos em uma única página de um objeto Recordset |
| RecordCount | Retorna o número de registros em um objeto Recordset |
| Sort | Define ou retorna os nomes de campo no conjunto de registos para classificar |
| Source | Define um valor de string ou uma referência objeto de comando, ou retorna um valor String que indica a fonte de dados do objeto Recordset |
| State | Retorna um valor que descreve se o objecto de registos é aberta, fechada, de ligação, de execução ou recuperar dados |
| Status | Retorna o status do registro atual em relação a atualizações em lote ou outras operações em massa |
| StayInSync | Define ou retorna se a referência para os registros filho vai mudar quando as mudanças de posição registro pai |
Métodos
| Método | Descrição |
|---|---|
| AddNew | Cria um novo registro |
| Cancel | Cancela uma execução |
| CancelBatch | Cancela uma atualização em lote |
| CancelUpdate | Cancela as alterações feitas em um registro de um objeto Recordset |
| Clone | Cria uma duplicata de um conjunto de registos existente |
| Close | Fecha um conjunto de registos |
| CompareBookmarks | Compara dois marcadores |
| Delete | Exclui um registro ou grupo de registros |
| Find | Procura um registro em um conjunto de registros que satisfaz um critério especificado |
| GetRows | As cópias múltiplas fichas a partir de um objecto de registos para uma matriz bidimensional |
| GetString | Retorna um conjunto de registros como uma string |
| Move | Move o ponteiro do registo de um objecto de registos |
| MoveFirst | Move o ponteiro do registro para o primeiro registro |
| MoveLast | Move o ponteiro do registro para o último registro |
| MoveNext | Move o ponteiro do registro para o próximo registro |
| MovePrevious | Move o ponteiro do registro para o registro anterior |
| NextRecordset | Limpa o objeto de registos actual e devolve o objecto seguinte conjunto de registos por ciclo através de uma série de comandos |
| 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 |
| Requery | Atualiza os dados em um conjunto de registros por re-executar a consulta que fez a registos original |
| Resync | Atualiza os dados do actual conjunto de registros do banco de dados original |
| Save | Salva um objeto Recordset para um arquivo ou um objeto Stream |
| Seek | Pesquisa o índice de um conjunto de registros para localizar um registro que corresponde aos valores especificados |
| Supports | Retorna um valor booleano que define se um objeto Recordset suporta um tipo específico de funcionalidade |
| Update | Salva todas as alterações feitas em um único registro em um objeto Recordset |
| UpdateBatch | Salva todas as alterações em um conjunto de registros no banco de dados. Utilizado quando se trabalha em modo de atualização em lote |
Eventos
Note: Você não pode lidar com eventos usando VBScript ou JScript (somente Visual Basic, Visual C ++ e linguagens Visual J ++ pode lidar com eventos).
| Evento | Descrição |
|---|---|
| EndOfRecordset | Acionado quando você tentar mover para um registro após o último registro |
| FetchComplete | Desencadeado após todos os registros em uma operação assíncrona ter sido buscada |
| FetchProgress | Desencadeada periodicamente em uma operação assíncrona, afirmar quantos mais registros que têm sido buscados |
| FieldChangeComplete | Desencadeado após o valor de uma mudança de objeto do campo |
| MoveComplete | Desencadeado após a posição atual no conjunto de registos mudou |
| RecordChangeComplete | Desencadeado após um registro foi alterado |
| RecordsetChangeComplete | Desencadeado após o Recordset mudou |
| WillChangeField | Desencadeado antes do valor de uma mudança de objeto do campo |
| WillChangeRecord | Desencadeado antes de uma alteração do registro |
| WillChangeRecordset | Desencadeado antes de uma mudança de registos |
| Moverá | Disparado antes da posição atual nas mudanças Recordset |
Colecções
| Coleção | Descrição |
|---|---|
| Fields | Indica o número de objetos de campo no objeto Recordset |
| Properties | Contém todos os objetos propriedade no objeto Recordset |
Propriedades A coleção de Campos
| Propriedade | Descrição |
|---|---|
| Count | Retorna o número de itens na coleção campos. Começa em zero. Exemplo: countfields = rs.Fields.Count |
| Item(named_item/number) | Retorna um item especificado na coleção campos. Exemplo: itemfields = rs.Fields. Item(1) |
Propriedades As propriedades da Coleção
| Propriedade | Descrição |
|---|---|
| Count | Retorna o número de itens na coleção propriedades. Começa em zero. Exemplo: countprop = rs.Properties.Count |
| Item(named_item/number) | Retorna um item especificado na coleção propriedades. Exemplo: itemprop = rs.Properties. Item(1) |