RequiredFieldValidator.InitialValue 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定相關輸入控制項的初始值。
public:
property System::String ^ InitialValue { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string InitialValue { get; set; }
[System.Web.UI.Themeable(false)]
public string InitialValue { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.InitialValue : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.InitialValue : string with get, set
Public Property InitialValue As String
屬性值
指定相關輸入控制項初始值的字串。 預設為 Empty。
- 屬性
範例
下列範例示範如何使用 InitialValue 屬性來確保使用者在文字框中輸入值。
重要
這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>RequiredFieldValidator InitialValue Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>RequiredFieldValidator InitialValue Example</h3>
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
InitialValue="Enter a value"
ControlToValidate="Text1"
ErrorMessage="Required field!"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
runat="server"/>
</form>
</body>
</html>
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>RequiredFieldValidator InitialValue Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>RequiredFieldValidator InitialValue Example</h3>
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
InitialValue="Enter a value"
ControlToValidate="Text1"
ErrorMessage="Required field!"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
runat="server"/>
</form>
</body>
</html>
下列範例示範如何使用 InitialValue 屬性來確保使用者從清單框中選取專案。
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>RequiredFieldValidator InitialValue Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>RequiredFieldValidator InitialValue Example</h3>
<asp:ListBox id="list"
runat="server">
<asp:ListItem Value="Australia">Australia</asp:ListItem>
<asp:ListItem Selected="True" Value="NoCountry">--ChooseCountry--</asp:ListItem>
<asp:ListItem Value="USA">USA</asp:ListItem>
</asp:ListBox>
<asp:RequiredFieldValidator id="valList"
ForeColor="#FF0000"
ErrorMessage="Selection Invalid!"
ControlToValidate="list"
InitialValue="NoCountry"
EnableClientScript="False"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Submit"
runat="server"/>
</form>
</body>
</html>
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>RequiredFieldValidator InitialValue Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>RequiredFieldValidator InitialValue Example</h3>
<asp:ListBox id="list"
runat="server">
<asp:ListItem Value="Australia">Australia</asp:ListItem>
<asp:ListItem Selected="True" Value="NoCountry">--ChooseCountry--</asp:ListItem>
<asp:ListItem Value="USA">USA</asp:ListItem>
</asp:ListBox>
<asp:RequiredFieldValidator id="valList"
ForeColor="#FF0000"
ErrorMessage="Selection Invalid!"
ControlToValidate="list"
InitialValue="NoCountry"
EnableClientScript="False"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Submit"
runat="server"/>
</form>
</body>
</html>
備註
使用這個屬性來指定輸入控件的初始值。
只有在相關聯的輸入控件值在失去焦點時,驗證 InitialValue 才會失敗。
注意
屬性和輸入控件中的 InitialValue 字串都會經過修剪,以在執行驗證之前移除字元串前後的額外空格。
這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊,請參閱 ThemeableAttribute 和 ASP.NET 主題和外觀。