Compartilhar via


Coleção de parâmetros (ADO)

Aplica-se ao: Access 2013, Office 2013

Contém todos os objetos Parameter de um objeto Command.

Comentários

Um objeto Command tem uma coleção Parameters composta de objetos Parameter.

O uso do método Refresh em uma coleção Parameters do objeto Command recupera as informações de parâmetro do provedor para o procedimento armazenado ou a consulta parametrizada especificada no objeto Command. Alguns provedores não oferecem suporte às chamadas de procedimento armazenadas ou às consultas parametrizadas; a chamada do método Refresh na coleção Parameters durante o uso desse provedor retornará um erro.

Se você não definiu seus próprios objetos Parameter e acessou a coleção Parameters antes de chamar o método Refresh, o ADO chamará automaticamente o método e preencherá a coleção.

Você pode minimizar as chamadas do provedor para melhorar o desempenho, se conhecer as propriedades dos parâmetros associadas ao procedimento armazenado ou à consulta parametrizada que quiser chamar. Use o método CreateParameter para criar objetos Parameter com as definições de propriedade adequadas e utilize o método Append para adicioná-las à coleção Parameters. Isso permite definir e retornar os valores de parâmetro sem ter de chamar o provedor para obter as informações do parâmetro. Se você estiver gravando para um provedor que não forneça as informações de parâmetro, deverá preencher manualmente a coleção Parameters por meio desse método para usar os parâmetros totalmente. Use o método Delete para remover os objetos Parameter da coleção Parameters, se necessário.

Os objetos da coleção Parameters de um Recordset sairão do escopo (e, por esse motivo, se tornarão não disponíveis), quando Recordset for fechado.