Validazione in Wisej.NET

Costruisci il modulo di assunzione ValidationClinic attorno a due opportunità per individuare gli errori: quando l'utente lascia un campo e quando l'utente salva. In Wisej.NET, questi controlli funzionano insieme in modo che un campo non modificato non possa sfuggire alla convalida.

Esegui controlli rapidi nell'evento Validating, prima che l'utente prosegua. Il browser segnala la modifica del focus, ma il gestore C sharp viene eseguito sul server. Mantenere il gestore breve evita di rallentare la navigazione ordinaria.

Utilizzare Convalida per decidere se il valore è accettabile. Annulla l'evento e spiega il problema quando non lo è. Convalidato segue solo un controllo riuscito, rendendolo il luogo appropriato per la pulizia, ad esempio la rimozione di un nome accettato.

Imposta il comportamento AutoValidate del modulo nel suo costruttore. In ciascun gestore, SetError spiega un valore rifiutato e e.Cancel lo rifiuta. Cancellare il messaggio dopo la correzione in modo che l'interfaccia rifletta il valore corrente anziché un errore precedente.

Mantieni l'attenzione su un campo non valido quando l'utente deve correggerlo. Assegna a Cancel una via di fuga separata impostando CausesValidation su false. In caso contrario, la convalida potrebbe impedire a qualcuno di abbandonare un modulo incompleto.

Prima di scrivere al cliente, chiamare ValidateChildren da Save. Questo controlla anche i campi che l'utente non ha mai visitato. Se qualche gestore annulla la validazione, interrompi il salvataggio; solo i valori accettati dovrebbero raggiungere l'operazione di scrittura e la sua gestione delle eccezioni.

Guarda il nome vuoto mantenere il focus mentre l'icona di errore spiega il perché. Dopo la correzione, il nome accettato viene tagliato. L'e-mail non valida viene rifiutata in modo indipendente, mentre Annulla chiude comunque il modulo senza richiedere la correzione di nessuno dei due campi.

Prova a salvare prima di toccare il campo e-mail. ValidateChildren rileva l'input mancante e impedisce la scrittura anche se non si è verificato alcun cambiamento di focus. Correggere l'indirizzo e salvare nuovamente per confermare che l'input valido segua il percorso corretto.

Per questo lab, collega la convalida del campo, la pulizia del valore riuscito e il controllo finale del salvataggio in un unico modulo di assunzione. Prova Annulla anche con input non validi. La nota di laboratorio dovrebbe spiegare in che modo questi percorsi impediscono dati errati senza intrappolare l'utente.

Dai al modulo di contatto un feedback che resta utile dopo il primo errore. Un ErrorProvider gestisce le icone, gli helper riutilizzabili decidono quali valori non sono validi e un riepilogo visibile consente agli utenti di rivedere insieme ogni problema.

Separare il controllo di un valore dalla visualizzazione del suo errore. I gestori dei campi indipendenti possono lasciare icone obsolete o cancellare messaggi non correlati. Un approccio condiviso fa sì che ogni correzione influisca sul campo pertinente preservando i problemi che necessitano ancora di attenzione.

Scegli il modo in cui ciascun messaggio raggiunge l'utente. SetError aggiunge un'icona accanto a un input, mentre InvalidMessage fornisce il tooltip del controllo. Il riepilogo fornisce testo leggibile per l'intero modulo, quindi gli errori non sono rilevabili solo passando il mouse.

Configura un singolo ErrorProvider per il modulo, con le icone fisse posizionate a destra. Lascia che ValidateEmail restituisca un risultato FieldValidation invece di modificare i controlli. Questa separazione mantiene la regola riutilizzabile e lascia la presentazione al modulo.

Applicare elabora ogni risultato, compresi quelli di successo. Un messaggio vuoto rimuove la vecchia icona di quel campo; anche i risultati non validi popolano il riepilogo. Restituendo se tutti i risultati sono stati superati, Salva una decisione chiara prima che i dati vengano scritti.

Abbina il feedback al problema. Inserisci una correzione sul campo accanto al suo input, spiega una regola aziendale nel riepilogo del salvataggio e invia un messaggio amichevole a un errore di sistema. Gli utenti devono comprendere quale azione è a loro disposizione.

Salva il modulo con i tre campi di contatto non validi. Confronta le icone locali con il riepilogo: entrambe dovrebbero descrivere gli stessi problemi rimanenti. La descrizione comando del codice cliente mostra il percorso di visualizzazione alternativo senza sostituire la spiegazione a livello di modulo.

Correggi solo l'e-mail e lascia quel campo. La sua icona e la voce di riepilogo scompaiono, ma rimangono il nome e i messaggi del telefono. Ciò dimostra perché i singoli risultati devono eliminare errori individuali anziché eliminare l'intero fornitore.

Costruisci gli aiutanti, condividi ErrorProvider e applica il metodo come un unico percorso di feedback. Verificare che la correzione di un campo conservi gli altri errori. Confronta il codice cliente InvalidMessage con le icone e il riepilogo per spiegare quando ogni presentazione è utile.

Spostare le regole dei campi ripetuti nell'extender di convalida. In Wisej.NET, la descrizione dei requisiti di ciascun campo consente all'extender di eseguire controlli coerenti per ValidationClinic, mentre il modulo rimane responsabile della presentazione di feedback utili all'utente.

L'extender si connette a Validating e Validated sui controlli. Invece di ripetere lo stesso controllo di valori vuoti in diversi gestori, allega i metadati della regola a ciascun campo. Il flusso degli eventi rimane familiare mentre le definizioni diventano più facili da condividere.

Scegli una regola integrata per il tipo di valore che accetti, ad esempio email, numero intero, valuta o telefono. Utilizza un'espressione regolare quando il modello richiesto lo richiede. Assegna a ciascuna regola un InvalidMessage che spieghi la correzione nella lingua dell'utente.

Aggiungi Validazione nella finestra di progettazione, quindi apri la raccolta ValidationRules di un controllo. Inserisci obbligatorio prima dell'e-mail. L'ordine di raccolta è anche ordine di esecuzione, quindi la disposizione di queste voci determina quale spiegazione riceve per prima l'utente.

Un errore di regola interrompe le regole rimanenti e annulla la convalida. Ecco perché un'e-mail vuota dovrebbe fallire. Obbligatorio innanzitutto: chiedere un indirizzo mancante è più utile che segnalare un problema di formato prima che esista l'indirizzo.

La configurazione del runtime segue lo stesso modello di regole. Crea gli array una volta in ClinicRules, seleziona la destinazione di visualizzazione, quindi assegna ciascun campo tramite SetValidationRules. Mantenere insieme le definizioni evita copie leggermente diverse della stessa regola tra i moduli.

Confronta un indirizzo vuoto, un indirizzo non corretto e uno valido. Ogni tentativo dovrebbe produrre solo il primo errore applicabile. Quando il valore diventa valido, sia l'icona che la voce di riepilogo vengono cancellate, confermando che la presentazione segue l'ultimo risultato di convalida.

Le regole possono inviare feedback al controllo, a uno ErrorProvider o a un'etichetta. Scegli deliberatamente la destinazione, quindi aggiorna il riepilogo dagli eventi dell'extender. Ciò mantiene il riepilogo sincronizzato con i controlli effettivamente eseguiti.

Sostituisci i gestori ripetuti con le definizioni ClinicRules condivise. Mantieni prima Richiesto e collega il riepilogo agli eventi dell'extender. Il test dovrebbe mostrare che i valori vuoti, non corretti e corretti producono il messaggio appropriato senza conservare un feedback obsoleto.

Modulo quattro. Convalida personalizzata in Wisej.NET. Un modulo può accettare valori formattati correttamente che comunque infrangono le regole aziendali. Risolviamolo.

Le regole integrate controllano la forma di un valore. Ma una data valida può comunque essere successiva a una data di fine e una data di nascita valida può appartenere a qualcuno troppo giovane. Queste sono le regole aziendali. Quando confronti i campi, calcoli un'età o controlli i valori insieme, scrivi una regola di convalida personalizzata.

La convalida personalizzata ha tre case. Innanzitutto, un metodo che restituisce un messaggio di errore. In secondo luogo, un servizio che restituisce i record ValidationMessage. In terzo luogo, una classe derivata da ValidationRule eseguita dall'extender di convalida. Scegli la casa che si adatta alla responsabilità del tuo governo.

ValidateStartEndDates restituisce una stringa vuota quando le date sono valide o un messaggio di errore quando non lo sono. Applica lo stesso messaggio a entrambi i selettori di date. Il servizio ContactValidator non ha alcuna dipendenza dai controlli. Convalida il modello, in modo da poter testare la logica aziendale senza l'interfaccia utente.

MinimumAgeValidationRule deriva da ValidationRule. Il suo metodo OnValidating restituisce vero o falso. Allega la regola al selettore della data di nascita con SetValidationRules. ApplyModelValidation collega i risultati del servizio allo schermo. Associa i nomi dei campi ai controlli, quindi ogni messaggio viene visualizzato in cui l'utente può risolvere il problema.

Il gestore Save esegue la convalida in ordine. Innanzitutto, controlla le regole del campo. Quindi esegui il servizio di convalida e la regola della data. Ritorna presto se uno strato fallisce. Chiamare il repository solo dopo aver superato ogni controllo. Il database non dovrebbe mai ricevere dati che la tua convalida ha già rifiutato.

Ora prova a salvare con la data di inizio successiva alla data di fine. Entrambi i selettori mostrano lo stesso errore e il riepilogo visualizza un singolo messaggio.

Correggere la data di fine. Entrambi gli errori si risolvono insieme. Poiché questa regola confronta due valori, entrambi i controlli condividono il feedback.

Inserisci una data di nascita tra le venti undici. La regola dell'età minima la rifiuta non appena l'utente lascia il selettore.

Correggi la data di nascita e l'errore verrà cancellato. Salva ora esegue correttamente ogni livello di convalida, quindi memorizza il contatto esattamente una volta.

Per il laboratorio quattro, implementare il controllo della data, il servizio di convalida, la mappatura dei messaggi e la regola dell'età minima.

Collegali in un gestore di salvataggio che non salva mai dati non validi.

Modulo cinque. Convalida associata ai dati in Wisej.NET. Il modulo di assunzione ora modifica un modello di modifica del contatto. Le sue regole di convalida di base appartengono ai dati, quindi le stesse regole possono proteggere il modulo, la griglia e altri modi per modificare un contatto.

Un gestore di moduli protegge solo le modifiche apportate tramite quel modulo. Una griglia, un'importazione o un servizio possono aggiornare lo stesso contatto senza eseguire tali gestori. Inserisci le regole di base nel modello, quindi esegui ogni percorso di salvataggio prima di accettare i dati.

Innanzitutto, completa la modifica corrente. Il valore ancora in fase di digitazione potrebbe non aver ancora raggiunto il modello. Fine chiamata Modifica sull'origine di associazione del contatto prima della convalida. Altrimenti, il validatore potrebbe controllare un valore più vecchio anche se l'utente ha già corretto il campo.

Le annotazioni sui dati descrivono le regole, ma non vengono eseguite da sole. Prova Validate Object li applica e raccoglie i risultati. Imposta valida tutte le proprietà su true. Senza questa opzione, viene selezionato solo Obbligatorio, quindi un'e-mail in formato non valido o un'età fuori dall'intervallo potrebbero passare.

Il validatore restituisce nomi di proprietà, non controlli. Utilizza una mappa del campo per collegare ciascun risultato all'input corretto. Inserisci il messaggio accanto a quell'input e nel riepilogo. Se una proprietà non ha un controllo corrispondente, mantieni il messaggio nel riepilogo in modo che l'errore sia ancora visibile.

C'è un altro approccio. Un modello che implementa I Data Error Info risponde alle domande di convalida per ciascuna proprietà. Un provider di errori associato a dati legge queste risposte. Quando si cambiano le origini in fase di runtime, Bind To Data And Errors imposta l'origine e il membro insieme, evitando una mancata corrispondenza temporanea.

Prova a salvare il contatto non valido. End Edit innanzitutto conferma l'input corrente nel modello. I controlli delle annotazioni rifiutano il nome, l'e-mail e l'età. La mappa del campo inserisce ogni messaggio accanto al suo input e nel riepilogo. Il percorso di salvataggio si interrompe prima di scrivere qualsiasi cosa.

Correggere i valori e salvare nuovamente. I controlli ora passano e il contatto viene salvato. Nel modello I Data Error Info, la cancellazione del nome ripristina l'icona di errore tramite l'associazione dati. Non è necessario che il modulo chiami Set Error per tale modifica.

Per il quinto laboratorio, associa l'editor al modello, completa le modifiche prima della convalida e mappa i risultati delle annotazioni sui campi e sul riepilogo. Collegare quindi il modello I Data Error Info tramite Bind To Data And Errors. Verificare che i dati non validi non raggiungano mai il repository.

La griglia dei contatti introduce un percorso di modifica diverso rispetto al modulo di assunzione. Una cella ha il proprio editor ed eventi di convalida, quindi riutilizza lo stesso intento aziendale tramite i gestori della griglia anziché aspettarti che i gestori dei campi di testo del modulo vengano eseguiti.

Separa i tre problemi prima di scegliere un gestore. Il formato email appartiene alla cella, l'età non numerica può non riuscire nella conversione e un contatto chiuso senza una data di chiusura viola una regola tra i campi. Un controllo non può spiegare tutti e tre in modo affidabile.

Durante la modifica, convalida e.FormattedValue perché contiene ciò che l'utente sta digitando ora. Lo Value memorizzato nella cella rappresenta ancora il precedente input impegnato. Controllare quel vecchio valore potrebbe accettare proprio l'errore appena introdotto dall'utente.

Utilizza il nome della colonna per selezionare la regola in CellValidating. Cancella il messaggio precedente di quella cella, controlla il valore modificato e annulla con una spiegazione chiara quando fallisce. Ciò mantiene l'utente accanto all'input che necessita di correzione.

Inserisci un errore a valore singolo nella cella e un errore di relazione nella riga. Prenota DataError per la conversione o il salvataggio degli errori segnalati dalla griglia. Salta il segnaposto della nuova riga, poiché non è ancora un contatto che richiede la convalida.

ValidateRow aggiorna insieme il messaggio della riga e la cella della data di chiusura, rendendo la relazione visibile a entrambi i livelli. In DataError, spiegare gli errori di conversione in un linguaggio normale e registrare l'eccezione separatamente in modo che la diagnosi non diventi responsabilità dell'utente.

Prova prima l'e-mail non valida: la convalida mantiene la modifica in atto e visualizza l'errore della cella. Quindi inserisci le lettere per l'età. Il simpatico messaggio di conversione mostra un diverso percorso di errore, anche se entrambi gli errori si sono verificati durante la modifica di una cella.

Il contatto chiuso non può ancora essere salvato finché non viene raggiunta la data di chiusura richiesta. L'errore di riga mantiene visibile la relazione, mentre il segnaposto viene ignorato. Immettere la data e salvare nuovamente per verificare che la correzione della regola consenta la persistenza.

Costruisci i controlli della griglia in base al valore modificato corrente, alle relazioni tra righe e agli errori di conversione semplici. Cancella gli errori delle celle riuscite e proteggi il salvataggio dagli errori rimanenti. Testare ogni livello separatamente in modo che una cella valida non possa nascondere una riga di contatti non valida.

Porta i controlli ValidationClinic in un unico percorso di salvataggio. La convalida del campo, del modello, dell'azienda e della rete ora deve cooperare in Wisej.NET, quindi un controllo riuscito a un livello non ignora mai un problema irrisolto a un altro.

I validatori corretti individualmente non garantiscono un salvataggio corretto. Una modifica in sospeso potrebbe lasciare il modello obsoleto o un errore della griglia potrebbe non raggiungere mai i controlli del modulo. Metti le fasi in un ordine fisso e richiedi che ogni fase abbia successo.

Reimposta il feedback e completa la modifica corrente prima di controllare i campi, il modello, le regole aziendali e le righe della griglia. Fermati alla prima fase fallita. Questa sequenza impedisce l'esecuzione del lavoro successivo con input non validi e mantiene l'eventuale scrittura dietro tutti i controlli.

Utilizza il contratto IErrorProvider per inviare messaggi senza vincolare la convalida a un display. SummaryErrorProvider conserva un messaggio per ciascun controllo e nasconde la sua etichetta quando non ne rimane nessuno. Il riepilogo può quindi riflettere gli stessi errori del feedback sul campo.

Ritorna in anticipo quando la convalida del campo o del modello fallisce. Se il salvataggio finale ha esito negativo, distingue un nome duplicato che l'utente può correggere da un errore di sistema che non può correggere. Indirizza il duplicato al suo campo e spiega con calma gli altri fallimenti.

Esamina il feedback come parte del flusso di lavoro, non solo come testo di errore. Spiega la correzione vicino al campo e nel riepilogo, conserva Annulla e mantieni tracce tecniche fuori dai messaggi degli utenti. Testare gli input mancanti, non validi, validi e limite.

Innanzitutto, il nome mancante e l'e-mail in formato errato interrompono il salvataggio durante la convalida del campo. Correggi questi campi e riprova. Il modello poi rifiuta l'età di centotrenta anni, mostrando perché il superamento dei controlli sul campo non rende facoltativi i controlli successivi.

La fase della griglia rileva i restanti problemi di posta elettronica e di righe chiuse e il riepilogo li spiega entrambi. Dopo queste correzioni, ogni fase ha esito positivo e il salvataggio viene completato. La conferma finale ora significa che l'intero percorso di convalida è stato superato.

Fornisci il percorso di salvataggio completo con il fornitore di riepilogo e l'assistente di messaggi condiviso. Includere la gestione delle eccezioni che distingue l'input correggibile dagli errori di sistema. Documentare i casi di test in modo che un altro sviluppatore possa riprodurre sia i salvataggi bloccati che le correzioni riuscite.