Controllo RequiredFieldValidator (riferimento generale)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Valuta il valore di un controllo di input per verificare che venga immesso un valore dall'utente.
<asp:RequiredFieldValidator
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
ControlToValidate="string"
CssClass="string"
Display="None|Static|Dynamic"
EnableClientScript="True|False"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ErrorMessage="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
InitialValue="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SetFocusOnError="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Note
Utilizzare il controllo RequiredFieldValidator per rendere il controllo di input un campo obbligatorio. La convalida del controllo di input non riesce se il valore iniziale in esso contenuto non cambia durante l'esecuzione della convalida. In tal modo è possibile evitare che l'utente lasci invariato il controllo di input associato. Per impostazione predefinita, il valore iniziale è una stringa vuota (""), che indica la necessità di immettere un valore nel controllo di input per superare la convalida.
Nota
Gli spazi supplementari all'inizio e alla fine del valore di input vengono rimossi prima dell'esecuzione della convalida,in modo da evitare che uno spazio immesso nel controllo di input passi la convalida.
Talvolta può essere necessario che il valore iniziale non sia una stringa vuota, ad esempio nel caso in cui si desideri che l'utente imposti un valore diverso da quello predefinito del controllo. È possibile ad esempio che un controllo ListBox con una voce selezionata, per impostazione predefinita, contenga istruzioni che indicano all'utente di selezionare un elemento dall'elenco. In tal caso, si desidera che l'utente selezioni un elemento dal controllo, ma non l'elemento contenente le istruzioni. È possibile impedire all'utente di selezionare l'elemento specificandone il valore iniziale. Se l'utente seleziona tale elemento, nel controllo RequiredFieldValidator viene visualizzato il messaggio di errore. Per specificare il valore iniziale del controllo di input associato, impostare la proprietà InitialValue.
Nota
La proprietà InitialValue non imposta il valore predefinito per il controllo di input.Inoltre non è necessario che la proprietà InitialValue corrisponda al valore predefinito del controllo di input.Essa indica semplicemente il valore che non si desidera venga immesso dall'utente nel controllo di input.Se tale valore risulta essere presente al momento della convalida del controllo di input, l'operazione non riesce.
È possibile associare più validator allo stesso controllo di input. È possibile ad esempio utilizzare contemporaneamente un controllo RequiredFieldValidator, per garantire l'input a un controllo, e un controllo RangeValidator, per assicurare che l'input sia compreso nell'intervallo di dati specificato.
Per ulteriori informazioni sul controllo RequiredFieldValidator, vedere la classe RequiredFieldValidator.
Esempio
Nell'esempio di codice riportato di seguito viene descritto come utilizzare il controllo RequiredFieldValidator per rendere il controllo TextBox un campo obbligatorio.
.gif "Nota sulla sicurezza") Nota sulla sicurezza |
|---|
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.Per ulteriori informazioni, vedere Script Exploits Overview. |
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>