Condividi tramite


Proprietà di base dei controlli di convalida

Le proprietà elencate nella tabella seguente sono valide per tutti i controlli di convalida.

Proprietà

ControlToValidate

L'ID a livello di codice del controllo di input consente al controllo di convalida di eseguire la valutazione. Se l'ID non è valido, verrà generata un'eccezione.

Display

Il comportamento di visualizzazione per il controllo di convalida specifico. Tale proprietà può essere uno dei valori riportati di seguito.

None: il controllo di convalida non viene mai visualizzato inline. Utilizzare questa opzione per visualizzare il messaggio di errore solo nel controllo ValidationSummary.

Static: il controllo di convalida consente di visualizzare un messaggio di errore se la convalida non riesce. Lo spazio per il messaggio di errore è assegnato sulla pagina Web, anche se il controllo di input supera la convalida. Il layout della pagina non viene modificato quando nel controllo di convalida viene visualizzato il messaggio di errore. Poiché il layout della pagina è statico, è necessario che più controlli di convalida dello stesso controllo di input occupino posizioni fisiche diverse nella pagina.

Dynamic: il controllo di convalida consente di visualizzare un messaggio di errore se la convalida non riesce. Lo spazio per il messaggio di errore è assegnato in maniera dinamica alla pagina quando la convalida non riesce. In tal modo più controlli di convalida possono condividere la stessa posizione fisica sulla pagina.

NotaNota
Poiché lo spazio per il controllo di convalida è creato in maniera dinamica, il layout fisico della pagina viene modificato.Per evitare che il layout della pagina venga modificato alla visualizzazione di un controllo di convalida, è necessario che l'elemento HTML che contiene il controllo di convalida venga ridimensionato in base alla dimensione massima del controllo.

EnableClientScript

Indica se la convalida sul lato client è stata attivata. È possibile disabilitare la convalida sul lato client su browser che supportano questa funzionalità impostando la proprietà EnableClientScript su false.

Enabled

Indica se il controllo di convalida è attivato. È possibile evitare che un controllo di input venga convalidato dal controllo di convalida impostando questa proprietà su false.

ErrorMessage

Messaggio di errore da visualizzare nel controllo ValidationSummary se la convalida non riesce. Se non è impostata la proprietà Text del controllo di convalida, in tale controllo viene visualizzato anche il testo se la convalida non riesce. La proprietà ErrorMessage viene utilizzata in genere per ottenere diversi tipi di messaggi per il controllo di convalida e per il controllo ValidationSummary.

NotaNota
La proprietà non consente di convertire i caratteri speciali in entità HTML.Il carattere minore di (<), ad esempio, non viene convertito in &lt;.In tal modo è possibile incorporare gli elementi HTML, ad esempio un elemento <img>, in questo valore della proprietà.

ForeColor

Specifica il colore in cui visualizzare il messaggio inline quando la convalida non riesce.

IsValid

Indica se il controllo di input specificato dalla proprietà ControlToValidate è valido.

SetFocusOnError

Indica se lo stato attivo è impostato sul controllo specificato dalla proprietà ControlToValidate quando la convalida non riesce.

Text

Se impostata, il messaggio è visualizzato nel controllo di convalida quando la convalida non riesce. Se la proprietà non è impostata, il testo specificato nella proprietà ErrorMessage è visualizzato nel controllo.

ValidationGroup

Specifica il nome del gruppo di convalida a cui appartiene questo controllo di convalida.

Vedere anche

Riferimenti

BaseValidator

Altre risorse

Sintassi per il controllo server di convalida