Ovládací prvek RequiredFieldValidator (obecné reference)
Vyhodnotí hodnotu vstupního ovládacího prvku pro ujištění se, že uživatel zadal hodnotu.
<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"
/>
Poznámky
Použijte ovládací prvek RequiredFieldValidator, chcete-li označit ovládací prvek jako povinné pole. Ověřování ovládacího prvku se nezdaří, pokud hodnota, kterou obsahuje, se nezmění z její výchozí hodny, jakmile je ověření vykonáno. To zabrání uživateli opuštění přiřazeného vstupního ovládacího prvku bez provedení změny. Ve výchozím nastavení je počáteční hodnota prázdný řetězec (""), což znamená, že musí být zadána hodnota do vstupního ovládacího prvku, aby mohl projít ověřováním.
.gif "Poznámka") Poznámka |
|---|
Mezery navíc na začátku a na konci vstupní hodnoty jsou odstraněny před prováděním ověřování.Tím se zabrání, aby mezera zadaná do vstupního ovládacího prvku neprošla ověřováním. |
V některých případech budete chtít mít počáteční hodnotu, která není prázdný řetězec. To je užitečné, pokud máte výchozí hodnotu pro ovládací prvek a chcete po uživateli, aby vybral jinou hodnotu. Například můžete mít ovládací prvek ListBox, ve výchozím nastavení s vybranou položkou, která obsahuje pokyny pro uživatele pro zvolení položky ze seznamu. Uživatel musí zvolit položku z ovládacího prvku, ale nechcete, aby uživatel zvolil položku obsahující pokyny. Může uživateli zabránit zadání položky označením této hodnoty jak počáteční. Jestliže uživatel vybere tuto položku, zobrazí ovládací prvek RequiredFieldValidator chybovou zprávu. Chcete-li určit počáteční hodnotu přidruženého vstupního ovládacího prvku, nastavte vlastnost InitialValue.
| Poznámka |
|---|
Vlastnost InitialValue nenastaví výchozí vstupní hodnotu pro ovládací prvek.Vlastnost InitialValue dokonce nemusí odpovídat výchozí vstupní hodnotě ovládacího prvku.Jednoduše určuje hodnotu, kterou nechcete, aby uživatel zadal do vstupního ovládacího prvku.Ověřování vstupního ovládacího prvku se nezdaří, pokud tuto hodnotu obsahuje při provádění ověřování. |
Více validátorů lze přidružit ke stejnému vstupnímu ovládacímu prvku. Například ovládací prvek RequiredFieldValidator lze použít k zajištění zadání do ovládacího prvku, zatímco současně může být ovládací prvek RangeValidator použit, aby bylo zajištěno, že vstup je v určeném rozsahu dat.
Další informace o ovládacím prvku RequiredFieldValidator, naleznete ve třídě RequiredFieldValidator.
Příklad
Následující příklad kódu demonstruje použití RequiredFieldValidator pro určení ovládacího prvku TextBox jako povinného pole.
.gif "Poznámka k zabezpečení") Poznámka k zabezpečení |
|---|
Tento příklad obsahuje textové pole přijímající vstup uživatele, což představuje potencionální bezpečnostní riziko.Ve výchozím nastavení webové stránky technologie ASP.NET ověřují, že vstup uživatele neobsahuje skript nebo prvky jazyka HTML.Další informace naleznete v tématu Přehled zneužití skriptů. |
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"/>