Método CreateParameter (ADO)

Cria um objeto Parameter com as propriedades especificadas.

Sintaxe

  
Set parameter = command.CreateParameter (Name, Type, Direction, Size, Value)  

Valor retornado

Retorna um objeto Parameter.

Parâmetros

Nome
Opcional. Um valor de cadeia de caracteres que contém o nome do objeto Parameter.

Tipo
Opcional. Um valor DataTypeEnum que especifica o tipo de dados do objeto Parameter.

Direção
Opcional. Um valor ParameterDirectionEnum que especifica o tipo de objeto Parameter.

Tamanho
Opcional. Um valor Long que especifica o comprimento máximo do valor do parâmetro em caracteres ou bytes.

Valor
Opcional. Uma Variant que especifica o valor do objeto Parameter.

Comentários

Use o método CreateParameter para criar um novo objeto Parameter com um nome, tipo, direção, tamanho e valor especificados. Todos os valores passados nos argumentos são gravados nas propriedades Parameter correspondentes.

Esse método não acrescenta automaticamente o objeto Parameter à coleção Parameters de um objeto Command. Isso permite definir propriedades adicionais cujos valores serão validados pelo ADO quando você acrescentar o objeto Parameter à coleção.

Se você especificar um tipo de dados de comprimento variável no argumento Type, será necessário passar um argumento Size ou definir a propriedade Size do objeto Parameter antes de acrescentá-lo à coleção Parameters; caso contrário, ocorrerá um erro.

Se você especificar um tipo de dados numérico (adNumeric ou adDecimal) no argumento Type, também será necessário definir as propriedades NumericScale e Precision.

Aplica-se A

Objeto Command (ADO)

Consulte Também

Exemplo dos métodos Append e CreateParameter (VB)
Exemplo dos métodos Append e CreateParameter (VC++)
Método Append (ADO)
Objeto Parameter
Coleção Parameters (ADO)