Procedura: configurare i parametri per gli adattatori dati
Aggiornamento: novembre 2007
In molti casi, gli oggetti Command (SelectCommand, InsertCommand, UpdateCommand e DeleteCommand) di un adattatore dati fanno riferimento a istruzioni SQL o a stored procedure che richiedono parametri. Se l'adattatore è stato creato mediante la Configurazione guidata adattatore dati, i parametri per i comandi sopra riportati verranno configurati automaticamente. Potrebbe tuttavia essere necessario configurare manualmente i parametri o apportare piccole modifiche a un insieme di parametri esistente.
.gif "Nota") Nota: |
|---|
Nella versione precedente di Visual Studio per le comunicazioni tra un'applicazione e un database venivano utilizzati degli adattatori dati. Mentre gli adattatori dati sono comunque un componente essenziale dei .Provider di dati .NET Framework (ADO.NET), gli oggetti TableAdapter sono componenti generati dalla finestra di progettazione che consentono di semplificare il processo di spostamento dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter. |
| Suggerimento: |
|---|
Per configurare i parametri dopo aver modificato l'istruzione SQL di un comando, è possibile selezionare l'opzione Rigenera insieme di parametri per il comando nel Generatore di query. |
| Nota: |
|---|
È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida in linea a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio. |
Per configurare i parametri per un adattatore dati
Creare un adattatore dati. Per informazioni dettagliate, vedere Creazione di adattatori dati.
Nella finestra di progettazione del form o del componente selezionare l'adattatore dati, quindi visualizzare la finestra Proprietà.
Espandere l'oggetto comando per il quale si desidera configurare i parametri, ad esempio UpdateCommand, quindi nella proprietà Parameters fare clic sul pulsante con i puntini di sospensione (...) per visualizzare la finestra Editor dell'insieme Parameter.
Per creare un nuovo oggetto parametro, fare clic su Aggiungi.
Inserire il nuovo parametro nella posizione di indice corretta nel relativo insieme facendo clic sulle frecce in Ordina per spostarlo.
Per impostare le proprietà dei parametri, selezionare il parametro dall'elenco Membri, quindi utilizzare la griglia delle proprietà nella parte destra. Nella tabella riportata di seguito verranno riportate le proprietà più comunemente impostate.
Proprietà
Descrizione
SourceColumn
Rappresenta il nome di una colonna in una tabella Dataset da cui verrà letto il valore del parametro. Questa proprietà viene utilizzata con i parametri che inseriscono i valori in un'istruzione UPDATE, INSERT o DELETE oppure in stored procedure equivalenti.
SourceVersion
Se il valore del parametro viene derivato mediante la proprietà SourceColumn, SourceVersion specificherà la versione di un record del dataset che dovrà essere utilizzata come origine dei valori dei parametri:
Originale: valore della colonna così come è stato letto dal database. Questa opzione viene utilizzata quando è necessario il valore di una colonna prima della modifica, ad esempio quando una chiave primaria viene modificata ma è necessaria la chiave precedente per trovare il il record nel database.
Corrente: valore della colonna dopo l'aggiornamento di un record. Si tratta in genere del valore da scrivere nel database.
Default: valore sul quale viene impostata una colonna se non viene fornito un valore in modo esplicito.
Value
Rappresenta un valore esplicito da impostare per il parametro. Questa proprietà è in genere impostata in fase di esecuzione anziché in modo statico in fase di progettazione.
Se entrambe le proprietà sono impostate, Value avrà la precedenza su SourceColumn.
NamedParameter
Un valore booleano che indica se il parametro corrisponde a una variabile (generalmente con il formato @nomeparametro) o a un segnaposto (generalmente un punto interrogativo). Se si utilizzano un oggetto SqlConnection e i parametri denominati, impostare questa proprietà su true.
DBType, Precision, Scale, Size
Rappresentano le informazioni sul tipo di dati nativi, presenti nell'archivio dati, del valore del parametro. Quest'ultimo viene convertito nel tipo specificato o da esso derivato.
Direction
Rappresenta una specifica che indica se il valore del parametro viene passato al comando o restituito:
Input: valore passato al comando. Questa è l'impostazione predefinita.
Output: valore passato da una stored procedure. (non applicabile alle istruzioni SQL)
InputOutput: valore passato a una stored procedure e restituito, in genere con un valore modificato.
ReturnValue: valore restituito esplicito. Per impostazione predefinita, il valore restituito è il primo elemento (valore di indice zero) nell'insieme dei parametri.
ParameterName
Rappresenta il nome in base al quale è possibile fare riferimento al parametro dell'insieme anziché in base al relativo valore di indice. Anche se non è obbligatorio, si consiglia di utilizzare un nome di parametro.
Per chiudere la finestra Editor dell'insieme Parameter, scegliere OK.
Per configurare i parametri per altri oggetti Command, ripetere i passaggi da 3 a 7.