Editor dell'insieme Parameters

Aggiornamento: novembre 2007

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.

1. Aprire il nodo relativo alle proprietà SelectCommand, UpdateCommand, InsertCommand e DeleteCommand.

2. Modificare la proprietà Parameters per aprire l'editor dell'insieme Parameters.

Nota:
Se si utilizzano strumenti di progettazione dati come ad esempio la Configurazione guidata TableAdapter 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.

Per ulteriori informazioni sui parametri, vedere Parametri dei comandi degli adattatori dati.

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

Concetti

Cenni preliminari sulla visualizzazione dei dati

Riferimenti

SqlParameter

Altre risorse

TableAdapter

Connessione ai dati in Visual Studio

Preparazione dell'applicazione al ricevimento di dati

Recupero di dati nell'applicazione

Visualizzazione di dati su form nelle applicazioni Windows

Modifica di dati nell'applicazione

Convalida dei dati

Salvataggio di dati