asp - asp.net - aspcode.it

COMMUNITY - Login
 Username:
 
 Password:
 
Voglio registrarmi!
Password dimenticata?
 Utenti on-line: 0
 Ospiti on-line: 6001
ASPCode.it - Store

  > > Articoli

Utilizzare i Validator Controls

Data di pubblicazione: 25/11/2003        Voto della community: 4,53 (Votanti: 5)


Grazie ai Validation Controls Ŕ possibile controllare le informazioni inserite nei vari campi dei Web Forms e visualizzare eventuali messaggi di errore.

Quando viene realizzato un Web Forms, per lo sviluppatore risulta estremamente semplice ed immediato capire quali valori possono essere inseriti in ogni singolo campo ma, spesse volte, il comportamento degli "utilizzatori finali" Ŕ differente; si rivela quindi molto importante prevedere tutti i possibili errori che possono essere generati durante la compilazione dei campi; ASP.NET aiuta a gestire questi eventi attraverso i Validation Controls.

Come usare i Validation Controls nei Web Forms

Grazie ai Validation Controls Ŕ possibile controllare le informazioni inserite nei vari campi dei Web Forms e visualizzare eventuali messaggi di errore e, soprattutto, non inviare la pagina se tutti campi non soddisfano alle condizioni impostate nei Validation Controls.

I Validation Controls possono essere eseguiti sia in modalitÓ Server side che in modalitÓ Client Side; se il browser utilizzato supporta DHTML, verranno automaticamente gestiti, oltre che in modalitÓ server side, anche in modalitÓ Client side.

I validator attualmente attivi sono i seguenti:

- <ASP:RequiredFieldValidator> Controlla se il campo contiene un valore
- <ASP:RangeValidator> Controlla se il campo contiene un intervallo numerico
- <ASP:CompareValidator> Controlla se il valore contenuto nel campo corrisponde ad un valore
- <ASP:RegularExpressionValidator> Controlla se il valore del campo corrisponde ad una specifica espressione
- <ASP:CustomValidator> Viene eseguita una convalida definita dall'utente
- <ASP:ValidationSummary> Visualizza un elenco di tutti gli errori di convalida

Per verificare la validitÓ dei valori inseriti nei campi presenti nel Form, basterÓ semplicemente inserire uno o pi¨ Validation Control (<asp:TipoControlValidator ...> </asp:TipoFieldValidator>) per ogni Campo che si desidera controllare.

Per gestire un Validation Control sono disponibili le seguenti proprietÓ principali:

- ControlToValidate Nome del controllo (campo) da validare

- Text Imposta il messaggio di errore da visualizzare. Il messaggio di errore verrÓ visualizzato nel punto esatto in cui si trova il comando di convalida.

- ErrorMessage Imposta il messaggio di errore visualizzato nel controllo ValidationSummary. 

- Display Se il controllo Ŕ stato inserito in una tabella, impostando la proprietÓ a static, Ŕ possibile evitare che la lunghezza della colonna subisca delle modifiche in seguito alla visualizzazione del comando di convalida; al contrario se viene impostato a dymamic la colonna potrÓ subire delle modifiche in seguito alla visualizzazione del messaggio di errore.

ed altre proprietÓ specifiche o appartenenti a determinati Validation Controls:

- ControlToCompare Campo di confronto per il Compare Validator
- ValuelToCompare Valore di confronto per il Compare Validator
- ValidationExpression Indica l'espressione del testo da convalidare
- ClientValidationFunction ProprietÓ del controllo Custom Validator
- OnServerValidate ProprietÓ del controllo Custom Validator
- DisplayMode ModalitÓ di visualizzazione del Validation Summary
- Header Text Intestazione del Validation Summary
- ShowSummary Attivazione del Validation Summary
- ShowMessageBox Consente di visualizzare gli errori del Validation Summary in una finestra di Windows
- Type Indica il tipo del campo da gestire (Currency, DateTime, Double, Integer, String)
- Operator Operatore di confronto fra due valori (Equal, NotEqual, GreaterThan ecc...) 
- ForeColor Consente di impostare il colore del messaggio di errore (Red, Green ...) 
- Enabled Consente di attivare/disattivare il controllo su un campo
- IsValid Restituisce un valore (true/false) che indica se il campo ha passato il test di convalida
- Validate Effettua la convalida su un campo ed aggiorna la propritÓ IsValid

La differenza tra la proprietÓ Text e la proprietÓ ErrorMessage Ŕ che Text viene utilizzata per visualizzare il messaggio di errore accanto al controllo, ErrorMessage viene invece utilizzata per visualizzare il messaggio di errore nel Validation Summary (elenco degli errori di validazione del Form); nel caso in cui non sia stata impostata la proprietÓ Text, verrÓ visualizzato il messaggio presente in ErrorMessage.

Required Field Validation Control

Attraverso questo controllo Ŕ possibile rendere obbligatorio (diverso da blank) un determinato campo:

<script language="C#" runat="server">

void HiBtn_Click(Object Src, EventArgs E)

{

  lblCiao.Text = "Ciao " + txtNome.Text + ", benvenuto nel mondo .NET!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire il Nome: <asp:textbox id="txtNome" runat="server"/>
<asp:button text="Invia" Onclick="HiBtn_Click" runat=server/>

<asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server"
  ControlToValidate="txtNome"
  ErrorMessage="(*) Errore... Il campo NOME Ŕ un campo obbligatorio!"
  ForeColor="Red">
</asp:RequiredFieldValidator>

<br/><br/><b><asp:Label id="lblCiao" runat="server" /></b><br/>

</form>

</body>

</html>

Come Ŕ facile intuire, il controllo "Required Field Validator" viene spesso associato ad altri Validation Controls, in questo modo Ŕ possibile controllare sia il fatto che il campo non pu˛ essere vuoto (Required Field Validator) sia altre condizioni.

Range validation control

Il Range Validator consente di verificare che il valore inserito sia compreso fra due valori specificati (quindi del tipo da ... a ...); per ottenere questo risultato basterÓ utilizzare le proprietÓ MaximunValue e MinimunValue, in aggiunta alla proprietÓ Type che consente di specificare il tipo (dataype) del valore da gestire.

<script language="C#" runat="server">

void Btn_Click(Object Src, EventArgs E)

{

  lblConfronto.Text = "Il numero inserito Ŕ compreso tra 1 e 10!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire un numero tra 1 e 10: <asp:textbox id="txtNumero" runat="server"/><br/>

<asp:RangeValidator id="RangeFieldValidator1" runat="server"
  ControlToValidate="txtNumero"
  MinimumValue="1"
  MaximumValue="10"
  Type="Integer"
  ErrorMessage="(*) Errore... Il numero deve essere compreso tra 1 e 10!"
  ForeColor="Red" >
</asp:RangeValidator >

<br/><br/>

<asp:button text="Enter" Onclick="Btn_Click" runat=server/>

<br/><br/>

<b><asp:Label id="lblConfronto" runat="server" /></b><br />

</form>

</body>

</html>

Compare validation control

Questo controllo presenta diversi ambiti di applicazione, consente di verificare:

- il tipo (datatype) di un campo (Currency, DateTime, Double, Integer, String)
- l'uguaglianza di due campi, utilizzando gli operatori (Equal, NotEqual, GreaterThan ecc...) 
- l'uguaglianza di un campo rispetto ad un valore fisso, utilizzando gli operatori (Equal, NotEqual, GreaterThan ecc...) 

Controllo sul tipo (datatype) di un campo:


<script language="C#" runat="server">

void Btn_Click(Object Src, EventArgs E)

{

  lblCiao.Text = "Hai " + txtAnni.Text + " anni !";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire l'etÓ: <asp:textbox id="txtAnni" runat="server"/>

<asp:CompareValidator id="CompareFieldValidator1" runat="server"
  ControlToValidate="txtAnni"
  Type="Integer"
  Operator="DataTypeCheck"
  ErrorMessage="(*) Errore... Inserire un numero!"
  ForeColor="Red" >
</asp:CompareValidator >

<br/><br/>

<asp:button text="Enter" Onclick="Btn_Click" runat=server/>

<br/><br/>

<b><asp:Label id="lblCiao" runat="server" /></b><br />

</form>

</body>

</html>

Confronto tra due campi:

<script language="C#" runat="server">

void Btn_Click(Object Src, EventArgs E)

{

  lblConfronto.Text = "Confronto eseguito con successo!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire l'indirizzo Email: <asp:textbox id="txtEmail" runat="server"/><br/>
Re-inserire l'indirizzo Email: <asp:textbox id="txtEmail1" runat="server"/>

<asp:CompareValidator id="CompareFieldValidator1" runat="server"
  ControlToValidate="txtEmail1"
  ControlToCompare="txtEmail"
  Type="String"
  Operator="Equal"
  ErrorMessage="(*) Errore... Controllare l'indirizzo Email inserito!"
  ForeColor="Red" >
</asp:CompareValidator >

<br/><br/>

<asp:button text="Enter" Onclick="Btn_Click" runat=server/>

<br/><br/>

<b><asp:Label id="lblConfronto" runat="server" /></b><br />

</form>

</body>

</html>


Confronto fra un campo ed un valore fisso:

<script language="C#" runat="server">

void Btn_Click(Object Src, EventArgs E)

{

  lblData.Text = "Hai inserito una data successiva al 01/01/2004!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire una Data: <asp:textbox id="txtData" runat="server"/><br/>

<asp:CompareValidator id="CompareFieldValidator1" runat="server"
  ControlToValidate="txtData"
  ValueToCompare="01/01/2004"
  Operator="GreaterThan"
  Type="Date"
  ErrorMessage="(*) Errore... La data deve essere successiva al 01/01/2004!"
  ForeColor="Red" >
</asp:CompareValidator >

<br/><br/>

<asp:button text="Enter" Onclick="Btn_Click" runat=server/>

<br/><br/>

<b><asp:Label id="lblData" runat="server" /></b><br />

</form>

</body>

</html>

Regular Expression validation control

Quando Ŕ necessario convalidare dei tipi di testo particolarmente complessi (che contengono dei simboli speciali) Ŕ possibile utilizzare il controllo "Regular Expression"; attraverso la proprietÓ ValidationExpression Ŕ possibile impostare l'espressione regolare da convalidare.


<script language="C#" runat="server">

void Btn_Click(Object Src, EventArgs E)

{

  lblTesto.Text = "Espressione regolare!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Indirizzo Email: <asp:textbox id="txtTesto" runat="server"/><br/>

<asp:RegularExpressionValidator id="RegularExpressionFieldValidator1" runat="server"
  ControlToValidate="txtTesto"
  ValidationExpression="^[\w-\.]+@([\w-]+\.)+[\w-]{2,3}$"
  Operator="GreaterThan"
  ErrorMessage="(*) Errore ... indirizzo Email non valido!"
  ForeColor="Red">
</asp:RegularExpressionValidator >

<br/><br/>

<asp:button text="Enter" Onclick="Btn_Click" runat=server/>

<br/><br/>

<b><asp:Label id="lblTesto" runat="server" /></b><br />

</form>

</body>

</html>


Cerchiamo di capire meglio come interpretare le Regular Expression analizzando la simbologia utilizzata. Prendiamo come esempio l'espressione corretta relativa ad un indirizzo Email:

"^[\w-\.]+@([\w-]+\.)+[\w-]{2,3}$"

Nella rappresentazione di un'espressione, alcuni simboli speciali sono preceduti dal carattere "\", questo evita di generare ambiguitÓ.

... ma vediamo nel dettaglio la simbologia:

- le epressioni iniziano sempre con il simbolo "^" e terminano con il simbolo "$"
- il simbolo "[ ]" indica un range di valori (da ... a ...)
- "\w" indica che sono consentiti valori alfanumerici (compreso il carattere "_") ed anche i caratteri "-" e ".", dato che il carattere "." Ŕ un carattere speciale viene indicato utilizzando la notazione "\."; "[\w-\.]" indica quindi l'insieme dei caratteri (tutti gli alfanumerici, "_", "-", ".")
- "+" questo simbolo indica che la stringa precedente pu˛ comparire un numero infinito di volte;
- "@" indica che il carattere "@" deve sempre essere presente 
- "([\w-]+\.)+" le parentesi "()" consentono di raggruppare le espressioni; "[\w-]+\." indica che Ŕ consentito qualunque carattere alfanumerico (compreso il carattere "_") e che deve terminare con il ".". Le espressioni prima del "+": "[\w-]" e "([\w-]+\.)" possono camparire infinite volte; infatti sono consenti indirizzi Email del tipo prova@prova1.prova2.it
- "[\w]{2,3}" consente di rappresentare gli ultimi 2 o 3 caratteri di un indirizzo Email, "{}" viene utilizzato per specificare il numero esatto di caratteri da utilizzare

L'espressione per la rappresentazione corretta di un numero telefonico Ŕ la seguente:

"^\d{4}-\d$"

- anche in questo caso l'epressione inizia con il simbolo "^" e termina con il simbolo "$"
- "\d{4}" il simbolo "\d" indica che Ŕ consentito qualunque numero, "{4}" 4 Ŕ il numero massimo di caratteri per il prefisso
- "\d": per il resto del numero Ŕ consentito qualunque tipo di carattere numerico (senza limiti di lunghezza)

Per maggiori dettagli sull'utilizzo delle espressioni nei controlli Regular Expression cliccare qui

Custom validation control

Quando il tipo di convalida da effettuare Ŕ troppo complessa ed i controlli precostituiti non riescono a soddisfarre le necessitÓ richieste Ŕ possibile creare un controllo personalizzato "Custom Validator". Il controllo utilizza sempre una validazione lato Server, ma Ŕ possibile anche utilizzare una validazione lato Client (per i browser che supportano DHTML); la gestione lato Client consente di controllare il valore del campo prima che le informazioni vengano inviate al Server.

Esempio di CustomValidator:

<asp:CustomValidator id="accessID"
  ControlToValidate="ID del campo da controllare"
  ClientValidationFunction="FunzioneClient"
  onServerValidate="FunzioneServer"
  ErrorMessage="(*) Errore ... Messaggio di errore!"
  Text="(*) Errore ... Messaggio di errore!"
  ForeColor="Colore"
  runat="server" />
</asp:CustomValidator >


Il controllo utilizza due proprietÓ, ClientValidationFunction e OnServerValidate, che contengono il nome delle funzioni utilizzate per convalidare il valore. La funzione ClientValidationFunction, solitamente Ŕ scritta in JavaScript, mentre la funzione OnServerValidate Ŕ scritta con i linguaggi gestibili dal Framework .NET (VB.NET, C#, J# ...)

La funzione lato Server riceve in ingresso un riferimento al comando di convalida e l'oggetto ServerValidateEventArgs che consente di recuperare il valore del campo utilizzando la proprietÓ Value, il risultato del controllo viene salvato nella proprietÓ IsValid (sempre dell'oggetto ServerValidateEventArgs).

Sub ServerValidate(objSource As Object, objArgs As ServerValidaEventArgs)

' Viene effettuato un controllo che restituisce un blnValid (True/False)

  Dim blnValid As Boolean = True

  Try

      Dim intNumber As Integer = objArgs.Value
     
      ....
' codice di controllo

      blnValid = True

      ....

  Catch objError As Exception

      blnValid = False

  Finally

      objArgs.IsValid = blnValid

  End Try

End Sub

La funzione lato Client riceve in ingresso un riferimento a se stessa objSource ed un oggetto contenente gli argomenti per la chiamata di funzione objArgs.

E' importante ricordare che, prima di creare una funzione di validazione lato Client, Ŕ necessario aver creato la corrispondente funzione lato Server (descritta precedentemente), questo consnete di evitare che delle procedure esterne possano accedere a risorse protette.

<script language="javascript">

funtion ClientValidate(objSource, objArgs)

// Viene effettuato un controllo che restituisce un blnValid (True/False)

{

  var blnValid = true;
  var intNumber = objArgs.Value;

      {

                ... // codice di controllo

                blnValid = false;

                break;

        }

      else

      blnValid = false;

    }

    else

    blnValid = false;

    objArgs.IsValid = blnValid;

}

</script>


E' possibile utilizzare un Validation Control senza impostare la propietÓ ControlToValidate, questa soluzione viene adottata quando Ŕ necessario validare controlli multipli o controlli ai quali non Ŕ possibile applicare nessun Validation Control (come ad esempio i CheckBox); in questo caso la proprietÓ Value delle funzioni lato Server e lato Client conterrÓ una stringa vuota (""). Nel caso appena illustrato, se non viene utilizzato il Validation Control per un campo CheckBox, Ŕ possibile utilizzare una funzione del tipo (lato Server):

void ServerValidation (object source, ServerValidateEventArgs args)

{

args.IsValid = (CheckBox1.Checked == true);

}

Validation Summary

Il Validation Summary consente di visualizzare tutti i campi non validi, elencando tutti gli ErrorMessage dei controlli che hanno generato errore. Le proprietÓ utilizzate sono:

- DisplayMode ModalitÓ di visualizzazione del Validation Summary (List, BulletList, SingleParagraph)
- Header Text Intestazione del Validation Summary
- ShowSummary Attivazione del Validation Summary
- ShowMessageBox Se impostata a true, consente di visualizzare gli errori del Validation Summary in una finestra di Windows
- ForeColor Colore dei messaggi visualizzati

E' possibile visualizzare l'elenco degli errori in due modi:
in una determinata posizione della pagina, utilizzando ShowSummary="True" :

<script language="C#" runat="server">

void HiBtn_Click(Object Src, EventArgs E)

{

  lblCiao.Text = "Ciao " + txtNome.Text + ", benvenuto nel mondo .NET!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire il Nome: <asp:textbox id="txtNome" runat="server"/>
<asp:button text="Invia" Onclick="HiBtn_Click" runat=server/>

<asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server"
  ControlToValidate="txtNome"
  ErrorMessage="(*) Errore... Il campo NOME Ŕ un campo obbligatorio!"
  ForeColor="Red">
</asp:RequiredFieldValidator>

<br/><br/>

<asp:ValidationSummary id="ValidationSummary1" runat="server"
  HeaderText="<b> Si sono verificati i seguenti errori ... </b>"
  ShowSummary="True"
  DisplayMode="List"
  ForeColor="Red">
</asp:ValidationSummary>

<br/><br/><b><asp:Label id="lblCiao" runat="server" /></b><br/>

</form>

</body>

</html>

oppure in una finestra di Windows, utilizzando ShowMessageBox="True" :

<script language="C#" runat="server">

void HiBtn_Click(Object Src, EventArgs E)

{

  lblCiao.Text = "Ciao " + txtNome.Text + ", benvenuto nel mondo .NET!";

}

</script>



<html>

<head>

<title>Esempio sui Validation Controls</title></head><body>

<form runat="server">

Inserire il Nome: <asp:textbox id="txtNome" runat="server"/>
<asp:button text="Invia" Onclick="HiBtn_Click" runat=server/>

<asp:RequiredFieldValidator id="RequiredFieldValidator1" runat="server"
  ControlToValidate="txtNome"
  ErrorMessage="(*) Errore... Il campo NOME Ŕ un campo obbligatorio!"
  ForeColor="Red">
</asp:RequiredFieldValidator>

<asp:ValidationSummary id="ValidationSummary1" runat="server"
  HeaderText="<b> Si sono verificati i seguenti errori ... </b>"
  ShowSummary="false"
  ShowMessageBox="True"
  DisplayMode="List"
  ForeColor="Red">
</asp:ValidationSummary>

<br/><br/><b><asp:Label id="lblCiao" runat="server" /></b><br/>

</form>

</body>

</html>



Si ringrazia DotNetIt.com per la gentile concessione dell'articolo.




Utenti connessi: 6001