Compartilhar via

Usando o objeto Command (Access)

Aplica-se ao: Access 2013, Office 2013

Depois de se conectar a uma fonte de dados, você precisa executar as solicitações nela para obter os conjuntos de resultados. O ADO encapsula este tipo de funcionalidade de comando no objeto Command.

Você pode usar o objeto Command para solicitar qualquer tipo de operação do provedor, considerando que o provedor pode interpretar a sequência do comando adequadamente. Uma operação comum para os provedores de dados é consultar um banco de dados e retornar os registros em um objeto Recordset. Recordsets serão abordados posteriormente neste e em outros capítulos; por enquanto, considere-os como ferramentas para manter e visualizar os conjuntos de resultados. Como com muitos objetos ADO, dependendo da funcionalidade do provedor, algumas propriedades, métodos e coleções do objeto Command podem gerar erros quando mencionados.

Nem sempre é necessário criar um objeto Command para executar um comando em uma fonte de dados. Você pode usar o método Execute no objeto Connection ou o método Open no objeto Recordset. Contudo, você deveria usar um objeto Command se precisar usar novamente um comando em seu código ou se precisar transmitir informações detalhadas sobre o parâmetro com seu comando. Esses cenários são abordados em detalhes posteriormente neste capítulo.

Observação

Determinados Commands podem retornar um resultado como um fluxo binário ou como um único Record em vez de um Recordset se houver suporte para isso pelo provedor. Além disso, alguns Commands não são destinados a retornar qualquer conjunto de resultados (por exemplo, uma consulta SQL Update). Este capítulo abordará o cenário mais comum, contudo executando Commands que retornam resultados em um objeto Recordset. Para obter mais informações sobre o retorno de resultados em Records ou Streams, consulte Capítulo 10: Records e Streams.

Esta seção inclui os seguintes tópicos: