Partilhar via

Objeto Parameter

  • Artigo

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

Observações

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 correspondentes de uma cláusula WHERE e outra para definir o nome da coluna para uma cláusula SORT BY.

parâmetro objetos representam parâmetros associados a consultas parametrizadas ou argumentos de entrada/saída e os 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, 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. Value é a propriedade padrão do objeto Parameter.

  • Defina ou retorne características de parâmetro com as propriedades Attributes, Direction, Precision, NumericScale, Sizee Type.

  • Passe dados binários ou de caractere 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 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 parâmetros 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

do objeto de comando (ADO)
método CreateParameter (ADO)
da Coleção de Parâmetros (ADO)
da coleção Properties (ADO)