Oggetto Parameter

  • Articolo

Rappresenta un parametro o un argomento associato a un oggetto Command in base a una stored procedure o a una query con parametri.

Osservazioni

Molti provider supportano comandi con parametri. Si tratta di comandi in cui l'azione desiderata viene definita una sola volta, ma vengono usate le variabili (o i parametri) per modificare alcuni dettagli del comando. Ad esempio, un'istruzione SQL SELECT può usare un parametro per definire i criteri di corrispondenza di una clausola WHERE e un altro per definire il nome della colonna per una clausola SORT BY.

Gli oggetti Parameter rappresentano i parametri associati alle query con parametri o agli argomenti di input e output e ai valori restituiti delle stored procedure. A seconda della funzionalità del provider, alcune raccolte, metodi o proprietà di un oggetto Parameter potrebbero non essere disponibili.

Con le raccolte, i metodi e le proprietà di un oggetto Parameter, è possibile eseguire le operazioni seguenti:

  • Impostare o restituire il nome di un parametro con la proprietà Name.

  • Impostare o restituire il valore di un parametro con la proprietà Value. Value è la proprietà predefinita dell'oggetto Parameter.

  • Impostare o restituire le caratteristiche dei parametri con le proprietà Attributes, Direction, Precision, NumericScale, Size e Type.

  • Passare dati di tipo carattere o binari lunghi a un parametro con il metodo AppendChunk.

  • Accedere agli attributi specifici del provider usando la raccolta Properties.

Se si conoscono i nomi e le proprietà dei parametri associati alla stored procedure o alla query con parametri che si desidera chiamare, è possibile usare il metodo CreateParameter per creare oggetti Parameter con le impostazioni di proprietà appropriate e usare il metodo Append per aggiungerli alla raccolta Parameters. In questo modo è possibile impostare e restituire i valori dei parametri senza dover chiamare il metodo Refresh nella raccolta Parameters per recuperare le informazioni sui parametri dal provider, un'operazione potenzialmente ad uso intensivo di risorse.

L'oggetto Parameter non è sicuro per lo scripting.

Questa sezione contiene l'argomento seguente.

Vedere anche

Oggetto Command (ADO)
Metodo CreateParameter (ADO)
Raccolta Parameters (ADO)
Raccolta Properties (ADO)