RequiredFieldValidator 控制項

RequiredFieldValidator 控制項會驗證另一控制項的值是否為其初始值以外的某值。

就驗證方面來說，它的表現與 ASP.NET System.Web.UI.WebControls.RequiredFieldValidator 控制項完全相同。

行動控制項語法

需要的屬性和具程式碼功能的項目以粗體樣式標註。

<mobile:RequiredFieldValidatorrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size={ NotSet|Normal|Small|Large }
   Font-Bold={ NotSet|False|True }
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Wrapping="{NotSet|Wrap|NoWrap}"

   ControlToValidate="IdOfTargetControl"
   Display="{None|Static|Dynamic}"
   ErrorMessage="ErrorTextForSummary"
   InitialValue="initialValueInTheControl">
innerText
</mobile:RequiredFieldValidator>

內含項目規則

下列控制項可以包含 RequiredFieldValidator 控制項。

控制項	註解
System.Web.UI.MobileControls.Form	可以包含任何數目的 RequiredFieldValidator 控制項。
System.Web.UI.MobileControls.Panel	可以包含任何數目的 RequiredFieldValidator 控制項。

RequiredFieldValidator 控制項不可以包含任何其他控制項。

裝置樣板

無

裝置的特定行為

在呈現任何驗證器時，除非控制項的 StyleReference 屬性 (Property) 一開始就設定為 Error，不然它的呈現之裝置特定性質與 Label 控制項的裝置特定呈現完全相同。當這種情形發生時，控制項將使用網頁樣式表中的錯誤樣式；如果沒有任何樣式表示存在，則會使用系統的預設樣式表。

範例

下列範例需要使用者輸入 1 到 23 之中的數字。它同時使用 RangeValidator 和 RequiredFieldValidator 控制項。

<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="VB" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="vb" runat="server">

Protected Sub Submit_OnClick(sender As Object, e As EventArgs)
   If Page.IsValid Then
      ActiveForm = Form2
   End If
End Sub

</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Label runat="server">
      Please enter an integer from 1 through 23
   </mobile:Label>

   <mobile:TextBox id="number" runat="server"/>

   <mobile:RangeValidator ControlToValidate="number"
      Type="Integer"
      MaximumValue="23"
      MinimumValue="1"
      runat="server">
      Invalid number
   </mobile:RangeValidator>

   <mobile:RequiredFieldValidator ControlToValidate="number" 
      runat="server">
      A number is required
   </mobile:RequiredFieldValidator>

   <mobile:Command runat="server" OnClick="Submit_OnClick">
      Submit
   </mobile:Command>

</mobile:Form>

<mobile:Form id="Form2" runat="server">
   <mobile:Label runat="server">Number is submitted</mobile:Label>
</mobile:Form>
[C#]
<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="C#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="c#" runat="server">

protected void Submit_OnClick(Object sender, EventArgs e)
{
   if (Page.IsValid)
   {
      ActiveForm = Form2;
   }
}

</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Label runat="server">
      Please enter an integer from 1 through 23
   </mobile:Label>

   <mobile:TextBox id="number" runat="server"/>

   <mobile:RangeValidator ControlToValidate="number"
      Type="Integer"
      MaximumValue="23"
      MinimumValue="1"
      runat="server">
      Invalid number
   </mobile:RangeValidator>

   <mobile:RequiredFieldValidator ControlToValidate="number" 
      runat="server">
      A number is required
   </mobile:RequiredFieldValidator>

   <mobile:Command runat="server" OnClick="Submit_OnClick">
      Submit
   </mobile:Command>

</mobile:Form>

<mobile:Form id="Form2" runat="server">
   <mobile:Label runat="server">Number is submitted</mobile:Label>
</mobile:Form>

請參閱

RequiredFieldValidator 類別 | RequiredFieldValidator 類別成員 | RequiredFieldValidator 控制項