Aggiunta di convalida

Articolo
03/05/2013

Questa lezione mostra come convalidare i dati che un utente immette in un'applicazione LightSwitch.

Aggiunta validazione dati

Quasi in tutte le applicazioni che interessano l'immissione dei dati, è necessario convalidare i dati prima che vengano salvati.Ad esempio, è possibile verificare che un numero di telefono contenga il numero corretto di cifre o che un campo obbligatorio non sia vuoto.

La finestra di progettazione dei dati contiene un esempio di un tipo di convalida: ogni campo dell'entità dispone di una casella di controllo Obbligatorio.Se un campo è contrassegnato come obbligatorio e il campo è vuoto, LightSwitch visualizza automaticamente un avviso quando l'utente tenta di salvare i dati.

È possibile inoltre gestire la convalida in LightSwitch impostando le proprietà di convalida o scrivendo il codice di convalida personalizzato.

Per impostare le proprietà di convalida

In Esplora soluzioni fare doppio clic su Contatti.
Nella finestra di progettazione dei dati, fare clic su <Aggiungi proprietà>, quindi digitare ContactState.
Verificare che il tipo sia String.
Nella finestra Proprietà selezionare la proprietà Lunghezza massima e digitare 2.

Questa impostazione assicura che non possono essere digitati più di due caratteri nel campo ContactState.

Per aggiungere un codice di convalida personalizzato

In Esplora soluzioni fare doppio clic su Order_Details.
Nella finestra di progettazione dei dati, selezionare il campo Quantità.
Nella finestra Proprietà, fare clic sul collegamento Convalida personalizzata.

Viene visualizzato l'Editor di codice e viene visualizzato un blocco di codice per il metodo Quantity_Validate.
Aggiungere il codice riportato di seguito al metodo Quantity_Validate sotto la riga di commento.

Attenzione

Aggiungere il codice Visual Basic o C#, a seconda del linguaggio di programmazione scelto quando è stato creato il progetto.
```
If Quantity < 1 Then
    results.AddPropertyError("Quantity must be greater than zero.")
End If
```
```
if (Quantity < 1) 
{
    results.AddPropertyError("Quantity must be greater than zero.");
}
```
Questo codice assicura che non è possibile salvare un valore inferiore a uno nel campo Quantità.Se un utente tenta di salvare un valore inferiore a uno, viene attivato un errore di convalida.

Attenzione
Aggiungere il codice Visual Basic o C#, a seconda del linguaggio di programmazione scelto quando è stato creato il progetto.

Informazioni dettagliate

Questa lezione ha mostrato come convalidare i dati impostando le proprietà di convalida o scrivendo il codice di convalida.Proprietà di convalida diverse sono disponibili per i diversi tipi di dati.Ad esempio, un tipo String dispone di una proprietà Lunghezza massima e un Integer dispone di proprietà Valore minimo e Valore massimo.Tutti i tipi dispongono di una proprietà Obbligatorio , che è la proprietà utilizzata per la casella di controllo Obbligatorio nella finestra di Progettazione dati.

Se si esamina l'entità Clienti, notare che le proprietà di convalida appaiono disattivate e non possono essere modificate.Alcuni campi come Indirizzo dispongono già di un valore nella proprietà Lunghezza massima.Non è possibile impostare le proprietà di convalida in un'entità da un'origine dati allegata; è possibile impostarle solo nelle entità create.

Se si desidera aggiungere la convalida per un'entità da un'origine dati allegata, è possibile farlo scrivendo il proprio codice di convalida.Non è possibile eseguire l'override delle proprietà di convalida esistenti a meno che si aggiunga una convalida più restrittiva.Ad esempio, per un campo che dispone di una Lunghezza massima di 30, non è possibile aggiungere il codice di convalida per impostare la lunghezza su 40.Tuttavia, è possibile aggiungere il codice per limitare la lunghezza a meno di 30.