No tutorial "Aprendendo ASP em dez dias", dei uma introdução aproximada ao ADO, que pode ser considerado tudo o que existe. Fala apenas sobre o método Open no objeto Connection para estabelecer uma conexão física com a fonte de dados e usar o método Close para desconectá-la; as alterações feitas no objeto Recordset usando os métodos AddNew, Update e Delete são mencionadas no objeto Recordset; na última página. Propriedades AbsolutePage e RecordCount. Aqui acho necessário falar sobre os métodos e propriedades de vários objetos do ADO de uma forma mais sistemática. Afinal, ADO não é usado apenas em ASP, mas também em VB e VC. Os principais objetos que quero mencionar durante estes dez dias são:
Objeto de conexão (representa uma conexão aberta com uma fonte de dados).
Objeto RecordSet (representa o conjunto completo de registros de uma tabela base ou o resultado de uma execução de comando).
Quanto ao objeto Parameter e ao objeto Command que estão intimamente relacionados aos procedimentos armazenados, iremos discuti-los em detalhes em tutoriais futuros.
Vamos primeiro falar sobre os métodos do objeto Connection:
1. Método aberto
connection.Open ConnectionString, UserID, Senha, Opções
ConnectionString Opcional, string contendo informações de conexão.
UserID Opcional, string contendo o nome de usuário utilizado no estabelecimento da conexão.
A senha é opcional, uma string contendo a senha usada para estabelecer a conexão.
Opções Opcional, valor ConnectOptionEnum. Determina se o método retorna após o estabelecimento da conexão (assíncrona) ou antes da conexão ser estabelecida (síncrona). Pode ser uma das seguintes constantes:
adConnectUnspecified (padrão) Abra a conexão de forma síncrona.
adAsyncConnect abre uma conexão de forma assíncrona.
2. Método de execução
connection.Execute CommandText, RecordsAffected
CommandText String contendo o texto da instrução SQL, nome da tabela, procedimento armazenado ou provedor específico a ser executado.
RecordsAffected Opcional, variável longa para a qual o provedor retorna a quantidade de registros afetados pela operação.
3. Método de fechamento
conexão.Fechar
Use o método Close para fechar o objeto Connection para liberar todos os recursos do sistema associados.
As coisas a serem observadas são:
(1) Fechar um objeto não o exclui da memória. Você pode alterar suas configurações de propriedade e abri-lo novamente mais tarde.
(2) Para excluir completamente o objeto da memória, defina a variável do objeto como Nothing.
(3) Ao usar o método Close para fechar o objeto Connection, qualquer objeto Recordset ativo associado à conexão também será fechado.
(4) Após fechar o objeto Connection, chamar qualquer método que precise abrir uma conexão com a fonte de dados gerará um erro.
Todos devem estar familiarizados com os três métodos acima.
Vamos falar sobre as propriedades do objeto Connection, mencioná-las brevemente.
1. Atributo Provider Use o atributo Provider para especificar o provedor OLE DB.
Deve-se observar que especificar provedores em vários locais ao chamar o método Open pode ter consequências imprevisíveis.
2. A propriedade ConnectionString contém informações usadas para estabelecer uma conexão com a fonte de dados.
3. O atributo ConnectionTimeout indica o tempo de espera durante o estabelecimento da conexão antes de encerrar a tentativa e gerar um erro, e um valor inteiro longo (em segundos) para aguardar a abertura da conexão. O valor padrão é 15.
4. O atributo Mode indica as permissões disponíveis para modificar dados no Connection.
Descrição constante
AdModeUnknown Valor padrão. Indica que a permissão não foi definida ou não pode ser determinada.
AdModeRead indica que as permissões são somente leitura.
AdModeWrite indica que as permissões são somente gravação.
AdModeReadWrite indica que as permissões são de leitura/gravação.
AdModeShareDenyRead impede que outros usuários abram conexões com permissões de leitura.
AdModeShareDenyWrite impede que outros usuários abram conexões com permissões de gravação.
AdModeShareExclusive impede que outros usuários abram conexões.
AdModeShareDenyNone impede que outros usuários abram conexões com quaisquer permissões.
As coisas a serem observadas são:
Use a propriedade Mode para definir ou retornar os direitos de acesso que o provedor está usando na conexão atual. A propriedade Mode só pode ser definida quando o objeto Connection estiver fechado.
Dito isto hoje, vamos falar sobre as propriedades do objeto RecordSet amanhã.