程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> 關於ASP.NET >> Validation服務器控件：RequiredFieldValidator控件

Validation服務器控件：RequiredFieldValidator控件

編輯：關於ASP.NET

閱讀此文請先查看網頁教學網的：ASP.NET入門教程:Validation服務器控件，簡單講述了Web服務器控件的使用方法。

定義和用法

RequiredFieldValidator 控件用於使輸入控件成為一個必選字段。計算輸入控件的值以確保用戶輸入值。

通過該控件，如果輸入值的初始值未改變，那麼驗證將失敗。默認地，初始值是空字符串 ("")。

注釋：輸入值的開頭和結尾的空格將在驗證前被刪除。

注釋：InitialValue 不為輸入控件設置默認值。它指示了您不希望用戶在輸入控件中輸入的值。

屬性

屬性描述 BackColor RangeValidator 控件的背景顏色 ControlToValidate 要驗證的控件的 id Display 驗證控件的顯示行為。

合法的值有：

None - 驗證消息從不內聯顯示。
Static - 在頁面布局中分配用於顯示驗證消息的空間。
Dynamic - 如果驗證失敗，將用於顯示驗證消息的空間動態添加到頁面。

EnableClientScript 布爾值，規定是否啟用客戶端驗證。 Enabled 布爾值，規定是否啟用驗證控件。 ErrorMessage

當驗證失敗時，在 ValidationSummary 控件中顯示的文本。

注釋：如果未設置 Text 屬性，文本也會顯示在該驗證控件中。

ForeColor 該控件的前景色。 id 控件的唯一 id。 InitialValue 規定輸入控件的初始值（開始值）。默認是 ""。 IsValid 布爾值，指示關聯的輸入控件是否通過驗證。 runat 規定該控件是一個服務器控件。必須設置為 "server"。 Text 當驗證失敗時顯示的消息。

語法

備注：使用 RequiredFieldValidator 控件使輸入控件成為強制字段。當驗證執行時，如果輸入控件包含的值仍為初始值而未更改，則該輸入控件驗證失敗。這會防止用戶使關聯的輸入控件保持不變。默認情況下，初始值為空字符串 ("")，這指示必須在輸入控件中輸入值方可通過驗證。

注意：請在執行驗證之前移除輸入值前後的多余空格。這樣可防止在輸入控件中輸入的空格通過驗證。

有時，您可能希望初始值不為空字符串。當輸入控件具有默認值而且希望用戶選擇其他值時，這將非常有用。例如，默認情況下，可能有一個具有選定輸入的 ListBox 控件，其中包含用戶從列表中選擇項的說明。用戶必須從控件中選擇一項，但您不希望用戶選擇包含說明的項。您可通過將該項的值指定為初始值來防止用戶選擇該項。如果用戶選擇該項，RequiredFieldValidator 控件將顯示它的錯誤信息。若要指定關聯輸入控件的起始值，請設置 InitialValue 屬性。

注意：InitialValue 屬性不設置輸入控件的默認值。InitialValue 屬性甚至不需要與輸入控件的默認值匹配。它僅指示您不希望用戶在輸入控件中輸入的值。當驗證執行時，如果輸入控件包含該值，則其驗證失敗。

多個驗證程序可與同一個輸入控件關聯。例如，可使用 RequiredFieldValidator 控件確保輸入到控件中，同時可用 RangeValidator 控件確保輸入在指定的數據范圍內。

示例

下面的代碼示例演示如何使用 RequiredFieldValidator 控件使 TextBox 控件成為強制字段。

Visual Basic

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"/>