Procedura: controllare la visualizzazione dei messaggi di errore di convalida per i controlli server ASP.NET
Aggiornamento: novembre 2007
In Microsoft Visual Web Developer è possibile visualizzare i messaggi di errore in quattro modi diversi, come descritto nella seguente tabella.
Metodo di visualizzazione |
Descrizione |
|---|---|
Inline |
Il messaggio di errore viene visualizzato accanto al controllo, nel punto in cui è situato il controllo di convalida. |
Riepilogo |
Il messaggio di errore viene visualizzato in un riepilogo di tutti gli errori separato, disponibile solo quando la pagina viene inviata dall'utente. Facoltativamente, è possibile visualizzare il messaggio di errore in una finestra di messaggio, ma questa opzione è disponibile solo nei browser che supportano il linguaggio HTML dinamico (DHTML). |
Inline e riepilogo |
Il messaggio di errore può essere visualizzato in modo diverso nel riepilogo e inline. È possibile utilizzare questa opzione per visualizzare inline un messaggio di errore più breve e con ulteriori informazioni nel riepilogo oppure per visualizzare un'icona di errore accanto al campo di input e un messaggio di errore nel riepilogo. |
Personalizzato |
È possibile creare una visualizzazione personalizzata dei messaggi di errore. Per ulteriori informazioni, vedere Procedura: visualizzare i messaggi di convalida personalizzati del lato server per i controlli server ASP.NET. |
Per visualizzare i messaggi di errore riepilogati, è necessario aggiungere un controllo alla pagina.
Per visualizzare messaggi di errore riepilogati
Aggiungere un controllo ValidationSummary alla pagina nel punto in cui si desidera visualizzare i messaggi di errore raccolti.
Impostare le proprietà ErrorMessage e Display dei singoli controlli di convalida.
Impostare la proprietà DisplayMode del controllo di riepilogo per formattare i messaggi di errore utilizzando uno dei seguenti valori definiti nell'enumerazione ValidationSummaryDisplayMode:
Valore
Visualizzazione
BulletList
Ogni messaggio di errore viene visualizzato come voce puntata in un elenco (impostazione predefinita).
List
Ogni messaggio di errore viene visualizzato sulla propria riga.
SingleParagraph
Ogni messaggio di errore viene visualizzato come frase all'interno di un paragrafo.
Se si associano singoli controlli di convalida a gruppi di convalida, sarà necessario utilizzare un controllo ValidationSummary per ciascun gruppo di convalida.
Per visualizzare i messaggi di errore inline e sotto forma di riepilogo, è necessario impostare diverse combinazioni di proprietà nei singoli controlli di convalida.
Per visualizzare messaggi di errore inline e riepilogati
Aggiungere un controllo ValidationSummary come descritto nella procedura precedente.
Impostare le proprietà ErrorMessage, Text e Display dei singoli controlli di convalida in base alla tabella seguente:
Opzione
È necessario un controllo ValidationSummary.
Impostazioni di proprietà sul controllo di convalida
Solo inline
No
Display = Static o Dynamic
ErrorMessage = <testo dell'errore> o Text = <testo dell'errore>
Solo riepilogo, compresa finestra di messaggio facoltativa
Sì
Display = None
ErrorMessage = <testo dell'errore> o Text = <testo dell'errore>
Inline e riepilogo, compresa finestra di messaggio facoltativa
Sì
Display = Static o Dynamic
ErrorMessage = <testo dell'errore per il riepilogo>
Text = <testo dell'errore inline o glifo>
Se sul client viene eseguito un browser che supporta DHTML, i messaggi di errore riepilogati possono essere visualizzati anche in una finestra di messaggio.
Per visualizzare i messaggi di errore riepilogati in una finestra di messaggio
Impostare la proprietà ShowMessageBox del controllo ValidationSummary su true.
Quando l'utente invia la pagina, gli errori verranno visualizzati sia nel controllo ValidationSummary sia nella finestra di messaggio.
Per visualizzare i messaggi di errore riepilogati solo in una finestra di messaggio, impostare la proprietà ShowSummary su false.
Vedere anche
Attività
Procedura: specificare il layout dei messaggi sul posto sui controlli server ASP.NET