editor dell'insieme Parameters
Consente di creare e configurare parametri (oggetti OleDbParameter, SqlParameter, OdbcParameter e OracleParameter) associati a un'istruzione SQL o una stored procedure in TableAdapters e adattatori dati.
Modifica dell'insieme Parameters
L'editor dell'insieme Parameters viene visualizzato quando si utilizza la finestra Proprietà per configurare un oggetto TableAdapter in Progettazione DataSet o un adattatore dati in un form o un componente.
Scegliere un TableAdapter nell'area Progettazione Dataset e selezionare la proprietà Parameters nella finestra Proprietà per aprire l'editor dell'insieme Parameters.
Aprire il nodo relativo alle proprietà SelectCommand, UpdateCommand, InsertCommand e DeleteCommand.
Modificare la proprietà Parameters per aprire l'editor dell'insieme Parameters.
Nota
Se si utilizzano strumenti di progettazione dati come ad esempio la TableAdapter (configurazione guidata) o la Configurazione guidata adattatore dati per configurare gli adattatori, i relativi parametri vengono impostati automaticamente.
Denominazione dei parametri
Le istruzioni o le stored procedure per questi comandi possono essere definite utilizzando segnaposto per i parametri.
Se si utilizza un oggetto OleDbDataAdapter, un'istruzione in cui è stato inserito un punto interrogativo come segnaposto potrebbe avere il seguente aspetto:
Select * From Customers Where City = ?
Se invece si utilizza un oggetto SqlDataAdapter, un'istruzione in cui sono stati inseriti parametri denominati potrebbe avere il seguente aspetto:
Select * From Customers Where City = @City
Se invece si utilizza un oggetto OracleDataAdapter, un'istruzione in cui sono stati inseriti parametri denominati di Oracle potrebbe avere il seguente aspetto:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
Nota
In Oracle quando si utilizzano parametri denominati in un'istruzione SQL o in una stored procedure, è necessario inserire il simbolo di due punti (:) prima del nome del parametro. Se tuttavia si fa riferimento a un parametro denominato in altri punti del codice (ad esempio quando viene chiamato il metodo Add), non è necessario anteporre i due punti (:) al parametro denominato, in quanto vengono forniti automaticamente dal provider di dati.
Aggiunta di parametri
L'insieme Parameters per un comando (ad esempio, Parameters) contiene un elenco di oggetti parametro utilizzati per passare valori alle istruzioni o alle stored procedure in fase di esecuzione. È quindi disponibile un oggetto parametro per ciascun valore di parametro da passare a un comando.
L'editor è suddiviso in due riquadri. Nel riquadro sinistro è possibile aggiungere e rimuovere parametri, mentre nel riquadro destro è possibile impostare le proprietà per i singoli parametri, quali ad esempio:
La proprietà ParameterName, mediante la quale è possibile fare riferimento al parametro nel codice.
Nota
Poiché per la classe SqlDataAdapter è necessario utilizzare parametri denominati, negli oggetti SqlParameter il nome deve essere sempre preceduto dal segno "@".
La proprietà SourceColumn che consente di determinare da quale porzione di un record di dati proviene il valore del parametro. Tale valore viene utilizzato durante gli aggiornamenti, quindi l'adattatore dati passa il valore di una determinata colonna al comando di aggiornamento.
La proprietà SourceVersion che viene utilizzata insieme alla proprietà SourceColumn. Se un record del dataset è stato modificato, sono disponibili più copie dello stesso record, ovvero il valore originale, così come è stato letto dall'origine dati, e il valore corrente, modificato rispetto al precedente. Quando si specifica il valore di una colonna da passare come parametro, occorre scegliere quale dei due valori passare. In generale, il valore originale viene utilizzato come parametro di una clausola WHERE per identificare il record nel database, mentre il valore corrente viene utilizzato nelle clausole SET o VALUES.
La proprietà Value che è un valore letterale esplicito da passare come parametro. Impostando questa proprietà viene ignorata la proprietà SourceColumn; le due proprietà infatti si escludono reciprocamente.
Elenco degli elementi dell'interfaccia utente
Aggiungi
Consente di creare un nuovo parametro nell'insieme. Per impostazione predefinita, la tabella è denominata Parametern, dove n è un numero sequenziale. È possibile rinominare il parametro impostandone la proprietà ParameterName nella griglia delle proprietà.Nota
Nell'editor dell'insieme OleDbParameter non viene verificato che il numero o il tipo di parametri creati per il comando sia corretto.
Tenere presente che, poiché i parametri vengono associati ai segnaposto nelle istruzioni o nei comandi in base alla loro posizione, è importante accertarsi che vengano disposti nell'insieme secondo l'ordine corretto.
Rimuovi
Consente di eliminare il parametro selezionato dall'insieme.
Vedere anche
Riferimenti
Concetti
Associazione di controlli Windows Form ai dati in Visual Studio
Associazione di controlli ai dati in Visual Studio
Altre risorse
Connessione ai dati in Visual Studio
Preparazione dell'applicazione al ricevimento di dati
Recupero di dati nell'applicazione