Objeto Parameter

Representa um parâmetro ou argumento associado a um objeto Command com base em uma consulta parametrizada ou 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 poderia usar um parâmetro para definir os critérios correspondentes de uma cláusula WHERE e outra para definir o nome da coluna para uma cláusula SORT BY.

Os objetos de parâmetro representam parâmetros associados a consultas parametrizadas ou os argumentos de entrada/saída e os valores retornados dos 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, métodos e propriedades de um objeto Parameter , você pode fazer o seguinte:

  • Defina ou retorne o nome de um parâmetro com a propriedade Name .

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

  • Defina ou retorne características de parâmetro com as propriedades Atributos, Direção, Precisão, NumericScale, Tamanho e Tipo .

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

  • Acesse 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 potencialmente intensiva em recursos.

O objeto Parameter não é seguro para scripts.

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

Consulte Também

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