Compartilhar via

Objeto Parameter (ADO)

  • Artigo

Aplica-se ao: Access 2013, Office 2013

Representa um parâmetro ou argumento associado ao objeto Command com base em uma consulta parametrizada ou em um procedimento armazenado.

Comentários

Muitos provedores suportam comandos parametrizados. Esses são comandos no quais a ação deseja é definida uma vez, mas as variáveis (ou parâmetros) são usados para alterar alguns detalhes do comando. Por exemplo, uma instrução SQL SELECT poderia usar um parâmetro para definir os critérios de correspondência de uma cláusula WHERE e outro para definir o nome da coluna de uma cláusula SORT BY.

Os objetos Parameter representam os parâmetros associados à consultas parametrizadas ou aos argumentos de entrada/saída e os valores de retorno de procedimentos armazenados. Dependendo da funcionalidade do provedor, alguns métodos e algumas coleções e propriedades de um objeto Parameter podem não estar disponíveis.

Com as coleções, os métodos e as propriedades de um objeto Parameter, você pode fazer o seguinte:

  • Definir ou retornar o nome de um parâmetro com a propriedade Name.

  • Definir ou retornar o valor de um parâmetro com a propriedade Value. Value é a propriedade padrão do objeto Parameter.

  • Definir ou retornar as características do parâmetro com as propriedades Attributes, Direction, Precision, NumericScale, Size e Type.

  • Passar os dados binários longos ou os dados de caracteres para um parâmetro com o método AppendChunk.

  • Acessar os atributos específicos do provedor com a coleção Properties.

Se você souber os nomes e as propriedades dos parâmetros associados ao procedimento armazenado ou à consulta parametrizada que será chamada, use o método CreateParameter para criar objetos Parameter com as definições de propriedade adequadas e use o método Append para adicioná-las à coleção Parameters. Isso permite a definição e o retorno dos valores do parâmetro sem ter de chamar o método Refresh na coleção Parameters para recuperar as informações do parâmetro a partir do provedor, uma operação de recursos potencialmente intensivos.