ADO - Command - i parametri di Command
Un insieme Parameters contiene tutti gli oggetti Parameter relativi ad un oggetto Command.
Utilizzando il metodo Refresh sull'insieme Parameters di un oggetto Command vengono recuperate informazioni sui parametri del provider per la stored procedure o la query con parametri specificata nell'oggetto Command.
Alcuni provider non supportano chiamate a stored procedure o a query con parametri, quindi è restituito un errore se si richiama il metodo Refresh sull'insieme Parameters utilizzando uno di questi provider.
Se non sono stati definiti oggetti Parameter personalizzati e si accede all'insieme Parameters prima di richiamare il metodo Refresh, ADO richiama automaticamente il metodo e compila l'insieme.
Se si conoscono le proprietà dei parametri associati alla stored procedure o alla query con parametri da richiamare, è possibile ridurre al minimo le chiamate al provider al fine di ottimizzare le prestazioni. Utilizzare il metodo
CreateParameter per creare oggetti Parameter con le impostazioni di proprietà appropriate e utilizzare il metodo Append per aggiungerli all'insieme Parameters. In tal modo è possibile impostare e restituire valori di parametri senza richiamare il provider per ottenere informazioni sui parametri. Se si scrive su un provider che non fornisce informazioni sui parametri, è necessario compilare manualmente l'insieme Parameters utilizzando questo metodo in modo da poter utilizzare i parametri. Utilizzare il metodo Delete per rimuovere gli oggetti Parameter dall'insieme qualora necessario.
Proprietà
Count
Indica il numero di oggetti contenuti nell'insieme. È una proprietà di sola lettura. Se il valore restituito è pari a 0, l'insieme è vuoto e non contiene nessun oggetto.
Nota
La numerazione degli oggetti nell'insieme parte da 0 e non da 1.
Metodi
Append
Accoda un nuovo oggetto all'insieme.
Sintassi
command.Parameters.Append oggetto
- command: rappresenta l'oggetto Command su cui si sta operando
- oggetto: è il nuovo oggetto Parameter da aggiungere
Descrivendo il parametro autonomamente è possibile ridurre il numero di chiamate al provider e di conseguenza migliorare le prestazioni quando si utilizzano stored procedure o query con parametri. Tuttavia è necessario conoscere le proprietà dei parametri associati alla stored procedure o alla query con parametri che si desidera chiamare.
Utilizzare il metodo
Command.CreateParameter per creare gli oggetti Parameter con le proprietà impostate adeguatamente prima di usare Append. In questo modo è possibile impostare e restituire i valori senza dovere chiamare il provider per le informazioni necessarie. Se si chiama un provider che non fornisce informazioni relative ai parametri è necessario compilare manualmente l'insieme Parameters utilizzando questo metodo per potere utilizzare i parametri.
Delete
Elimina un oggetto dall'insieme.
Sintassi
command.Parameters.Delete indice
- command: è l'oggetto Command su cui si sta operando
- indice: è il nome dell'oggetto che si desidera eliminare o il suo numero ordinale
Osservazioni
Utilizzando Delete su un insieme si rimuove uno degli oggetti di quell'insieme.
Quando si chiama Delete è necessario utilizzare la proprietà Name dell'oggetto oppure l'indice dell'insieme corrispondente. Una variabile oggetto non è un argomento valido.
Item
Restituisce un membro specifico dell'insieme in base al nome o al numero ordinale.
Sintassi
oggetto = command.Parameters.Item( indice )
- oggetto è la variabile Parameter che riceve l'oggetto richiesto
- command è l'oggetto Command su cui si sta operando
- indice è il nome o il numero ordinale dell'oggetto da reperire
Osservazioni
Utilizzare Item per reperire un oggetto specifico nell'insieme. Se non è possibile trovare nell'insieme un oggetto corrispondente all'argomento indice, si verifica un errore.
Item è il metodo predefinito per tutti gli insiemi, quindi è possibile utilizzare anche la forma "ridotta" del metodo.
oggetto = command.Parameters(indice)
Refresh
Aggiorna gli oggetti dell'insieme in modo che corrispondano agli oggetti specifici disponibili presso il provider.
Sintassi
command.Parameters.Refresh
- command è l'oggetto Command su cui si sta operando
Osservazioni
Utilizzando Refresh è possibile recuperare le informazioni sui parametri sul lato provider per la stored procedure o la query con parametri specificata. l'insieme risulta vuoto per i provider che non supportano le chiamate di stored procedure o le query con parametri.
Impostare la proprietà ActiveConnection dell'oggetto Command su un oggetto Connection valido, la proprietà CommandText su un comando valido e la proprietà CommandType su adCmdStoredProc prima di chiamare Refresh.
Se si accede all'insieme Parameters prima di chiamare Refresh, il metodo è chiamato automaticamente e l'insieme è compilato.
Nota
Se si utilizza Refresh per ottenere informazioni sui parametri dal provider e tale metodo restituisce uno o più oggetti Parameter con tipo di dati a lunghezza variabile, è possibile che venga allocata memoria per i parametri in base alla relativa dimensione potenziale massima, causando un errore durante l'esecuzione. Per evitare che si verifichino errori, è necessario impostare esplicitamente la proprietà Size per questi parametri prima di chiamare Execute.
Riferimenti
La pagina principale di ADO
l'oggetto Command
Categories
ADO
Database
Non ci sono commenti. [Aggiungere un commento]