Поделиться через

RequiredFieldValidator.InitialValue Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает начальное значение связанного входного элемента управления.

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

Значение свойства

String

Строка, указывающая начальное значение связанного элемента управления входными данными. Значение по умолчанию — Empty.

Атрибуты
BindableAttribute ThemeableAttribute

Примеры

В следующем примере показано, как использовать InitialValue свойство, чтобы убедиться, что пользователь вводит значение в текстовом поле.

Это важно

В этом примере есть текстовое поле, которое принимает входные данные пользователя, которое является потенциальной угрозой безопасности. По умолчанию ASP.NET веб-страницы проверяют, что входные данные пользователя не включают скрипт или ЭЛЕМЕНТЫ 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 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 темы и скины.

Применяется к