Compartilhar via

Objeto Parameter

  • Artigo

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

Comentários

Muitos provedores dão suporte a comandos parametrizados. Estes são comandos nos quais a ação desejada é definida uma vez, mas variáveis (ou parâmetros) são usadas para alterar alguns detalhes do comando. Por exemplo, uma instrução SQL SELECT pode 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 para uma cláusula SORT BY.

Os objetos Parameter representam parâmetros associados a consultas parametrizadas ou argumentos de entrada/saída e valores retornados de procedimentos armazenados. Dependendo da funcionalidade do provedor, algumas coleções, métodos ou 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 características de parâmetro com as propriedades Attributes, Direction, Precision, NumericScale, Sizee Type.

  • Transmita dados binários longos ou de caractere a um parâmetro com o método AppendChunk.

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

Se você souber os nomes e as propriedades dos parâmetros associados ao procedimento armazenado ou à consulta parametrizada que deseja chamar, poderá usar o método CreateParameter para criar objetos Parameter com as configurações de propriedade apropriadas e usar o método Append para adicioná-los à coleção Parameters. Isso permite que você defina e retorne valores de parâmetro sem precisar chamar o método Refresh na coleção Parameters para recuperar as informações de parâmetro do provedor, uma operação que possivelmente usará muitos recursos.

O objeto Parameter não é seguro para scripts.

Esta seção contém o tópico a seguir.

Confira também

Objeto Command (ADO)
Método CreateParameter (ADO)
Coleção Parameters (ADO)
Coleção Properties (ADO)