RequiredFieldValidator 類別 (System.Web.UI.WebControls)

全部折疊

語言篩選

本頁僅適用於

Microsoft Visual Studio 2008/.NET Framework 3.5

其他版本也適用於下列軟體：

Microsoft Visual Studio 2005/.NET Framework 2.0

.NET Framework 類別庫

RequiredFieldValidator 類別

更新：2007 年 11 月

讓相關輸入控制項成為必要的欄位。

命名空間： System.Web.UI.WebControls
組件： System.Web (在 System.Web.dll 中)

語法

Visual Basic (宣告)

<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class RequiredFieldValidator _
    Inherits BaseValidator

Visual Basic (使用方式)

Dim instance As RequiredFieldValidator

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class RequiredFieldValidator : BaseValidator

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class RequiredFieldValidator : public BaseValidator

/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class RequiredFieldValidator extends BaseValidator

JScript

public class RequiredFieldValidator extends BaseValidator

ASP.NET

<asp:RequiredFieldValidator />

備註

使用這個控制項讓輸入控制項成為必要的欄位。如果輸入控制項在遺失焦點時沒有從 InitialValue 屬性變更其數值，就無法通過驗證。

多個驗證器可以和同一個輸入控制項產生關聯。例如，RequiredFieldValidator 可用來確認控制項的輸入，而同時 RangeValidator 可用來確認輸入是在指定的資料範圍內。

注意事項：
當您在 UpdatePanel 控制項內使用 RequiredFieldValidator 控制項時，請確定驗證器控制項與相關聯的控制項位於相同的面板中。如需使用部分網頁更新之 UpdatePanel 控制項的詳細資訊，請參閱網頁局部呈現概觀。

如需驗證控制項的額外資訊，請參閱 BaseValidator。

可及性

根據預設為這個控制項呈現的標記，可能與可及性標準 (例如 Web 內容可及性方針 1.0 (WCAG) 優先權 1 方針) 不一致。如需這個控制項之可及性支援的詳細資料，請參閱 ASP.NET 控制項和網頁可及性。

Topic	Location
HOW TO：以程式的方式測試 ASP.NET 伺服器控制項的有效性	建置 ASP .NET Web 應用程式
HOW TO：以程式的方式測試 ASP.NET 伺服器控制項的有效性	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：以程式的方式驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：以程式的方式驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：使用 ASP.NET 伺服器控制項的自訂函式驗證	建置 ASP .NET Web 應用程式
HOW TO：使用 ASP.NET 伺服器控制項的自訂函式驗證	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：停用 ASP.NET 伺服器控制項的驗證	建置 ASP .NET Web 應用程式
HOW TO：停用 ASP.NET 伺服器控制項的驗證	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：在 ASP.NET 伺服器控制項中，指定就地訊息的配置	建置 ASP .NET Web 應用程式
HOW TO：在 ASP.NET 伺服器控制項中，指定就地訊息的配置	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：格式化 ASP.NET 伺服器控制項的驗證錯誤訊息	建置 ASP .NET Web 應用程式
HOW TO：格式化 ASP.NET 伺服器控制項的驗證錯誤訊息	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：比對模式驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：比對模式驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：比對特定值驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：比對特定值驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：比對範圍值驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：比對範圍值驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：比對資料型別驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：比對資料型別驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：比對資料庫值驗證 ASP.NET 伺服器控制項	建置 ASP .NET Web 應用程式
HOW TO：比對資料庫值驗證 ASP.NET 伺服器控制項	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：顯示 ASP.NET 伺服器控制項的伺服器端自訂驗證訊息	建置 ASP .NET Web 應用程式
HOW TO：顯示 ASP.NET 伺服器控制項的伺服器端自訂驗證訊息	在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO：驗證 ASP.NET 伺服器控制項的必要項目	建置 ASP .NET Web 應用程式
HOW TO：驗證 ASP.NET 伺服器控制項的必要項目	在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說：驗證 Web Form 網頁中的使用者輸入	在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說：驗證 Web Form 網頁中的使用者輸入	使用 Visual Web Developer 建置應用程式

範例

下列範例說明如何使用 RequiredFieldValidator 控制項來確認使用者輸入數值至文字方塊中。

安全性注意事項：
這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。如需詳細資訊，請參閱指令碼攻擊概觀。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>RequiredField Validator Example</title>
<script runat="server">

      Sub ValidateBtn_Click(sender As Object, e As EventArgs) 

         If Page.IsValid Then 

            lblOutput.Text = "Required field is filled!"

         Else 

            lblOutput.Text = "Required field is empty!"

         End If

      End Sub

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>RequiredField Validator Example</h3>

      <table style="background-color:#eeeeee; padding:10">
         <tr valign="top">
            <td colspan="3">
               <asp:Label ID="lblOutput" 
                    Text="Fill in the required field below"
                    runat="server"
                    AssociatedControlID="TextBox1"/>
               <br />
            </td>
         </tr>

         <tr>
            <td colspan="3">
               <b>Credit Card Information</b>
            </td>
         </tr>

         <tr>
            <td align="right">
               Card Number:
            </td>
            <td>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>
            </td>
            <td>
               <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                    ControlToValidate="TextBox1"
                    Display="Static"
                    ErrorMessage="*"
                    runat="server"/> 
            </td>
         </tr>
         <tr>
            <td></td>
            <td>
               <asp:Button id="Button1" 
                    Text="Validate" 
                    OnClick="ValidateBtn_Click" 
                    runat="server"/>
            </td>
            <td></td>
         </tr>
      </table>

   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>RequiredField Validator Example</title>
<script runat="server">

      void ValidateBtn_Click(Object sender, EventArgs e) 
      {

         if (Page.IsValid) 
         {
            lblOutput.Text = "Required field is filled!";
         }
         else 
         {
            lblOutput.Text = "Required field is empty!";
         }
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>RequiredField Validator Example</h3>

      <table style="background-color:#eeeeee; padding:10">
         <tr valign="top">
            <td colspan="3">
               <asp:Label ID="lblOutput" 
                    Text="Fill in the required field below"
                    runat="server"
                    AssociatedControlID="TextBox1"/>
               <br />
            </td>
         </tr>

         <tr>
            <td colspan="3">
               <b>Credit Card Information</b>
            </td>
         </tr>

         <tr>
            <td align="right">
               Card Number:
            </td>
            <td>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>
            </td>
            <td>
               <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                    ControlToValidate="TextBox1"
                    Display="Static"
                    ErrorMessage="*"
                    runat="server"/> 
            </td>
         </tr>
         <tr>
            <td></td>
            <td>
               <asp:Button id="Button1" 
                    Text="Validate" 
                    OnClick="ValidateBtn_Click" 
                    runat="server"/>
            </td>
            <td></td>
         </tr>
      </table>

   </form>

</body>
</html>

None

<html>
<head>
   <script language="C#" runat=server>











   </script>

</head>
<body>

<h3><font face="Verdana">RequiredField Validator Sample</font></h3>
<p>

<form runat="server">

   <table bgcolor="#eeeeee" cellpadding=10>
      <tr valign="top">
         <td colspan=3>
            <asp:Label ID="lblOutput" 
                 Text="Fill in the required field below"
                 ForeColor="red" 
                 Font-Name="Verdana" 
                 Font-Size="10" runat=server /><br>
         </td>
      </tr>

      <tr>
         <td colspan=3>
            <font face=Verdana size=2><b>Credit Card Information</b></font>
         </td>
      </tr>

      <tr>
         <td align=right>
            <font face=Verdana size=2>Card Number:</font>
         </td>
         <td>
            <asp:TextBox id=TextBox1 runat=server />
         </td>
         <td>
            <asp:RequiredFieldValidator id="RequiredFieldValidator2"
                 ControlToValidate="TextBox1"
                 Display="Static"
                 Width="100%" runat=server>
                 *
            </asp:RequiredFieldValidator>

         </td>
      </tr>
      <tr>
         <td></td>
         <td>
            <asp:Button id=Button1 
                 text="Validate" 
                 OnClick="ValidateBtn_Click" 
                 runat=server />
         </td>
         <td></td>
      </tr>
   </table>

</form>

</body>
</html>

使用權限

AspNetHostingPermission
在裝載環境中運作所需。要求值：LinkDemand，權限值：Minimal。
AspNetHostingPermission
在裝載環境中運作所需。要求值：InheritanceDemand，權限值：Minimal。

繼承階層架構

System..::.Object
  System.Web.UI..::.Control
    System.Web.UI.WebControls..::.WebControl
      System.Web.UI.WebControls..::.Label
        System.Web.UI.WebControls..::.BaseValidator
          System.Web.UI.WebControls..::.RequiredFieldValidator

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

平台

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.5、3.0、2.0、1.1、1.0

請參閱

參考

RequiredFieldValidator 成員

System.Web.UI.WebControls 命名空間

RangeValidator

InitialValue

標記

: 新增標記

社群內容

新增內容

註解

管理您的個人檔案 | 與我們連絡 | 電子快訊