BaseValidator.ControlToValidate Свойство

Определение

Получает или задает проверяемый элемент управления для ввода.Gets or sets the input control to validate.

public:
 property System::String ^ ControlToValidate { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ValidatedControlConverter))]
[System.Web.UI.Themeable(false)]
public string ControlToValidate { get; set; }
member this.ControlToValidate : string with get, set
Public Property ControlToValidate As String

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

Проверяемый элемент управления для ввода.The input control to validate. Значение по умолчанию равно Empty и показывает, что значение свойства не задано.The default value is Empty, which indicates that this property is not set.

Атрибуты

Примеры

В следующем примере кода показано, как использовать ControlToValidate свойство для указания элемента управления вводом для проверки.The following code example demonstrates how to use the ControlToValidate property to specify the input control to validate.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="False" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Комментарии

ControlToValidate Используйте свойство, чтобы указать элемент управления вводом для проверки.Use the ControlToValidate property to specify the input control to validate. Для этого свойства необходимо задать идентификатор элемента управления вводом для всех элементов управления проверки, кроме CustomValidator элемента управления, который можно оставить пустым.This property must be set to the ID of an input control for all validation controls except the CustomValidator control, which can be left blank. Если не указать допустимый элемент управления вводом, при отрисовке страницы будет создано исключение.If you do not specify a valid input control, an exception will be thrown when the page is rendered. Идентификатор должен ссылаться на элемент управления в том же контейнере, что и элемент управления проверки.The ID must refer to a control within the same container as the validation control. Он должен находиться на той же странице или в одном пользовательском элементе управления или быть в том же шаблоне шаблонного элемента управления.It must be in the same page or user control, or it must be in the same template of a templated control.

Ниже перечислены стандартные элементы управления, которые могут быть проверены:The standard controls that can be validated are:

Примечание

Для проверки System.Web.UI.ValidationPropertyAttribute элемента управления вводом атрибут должен быть применен к элементу управления.For an input control to be validated, the System.Web.UI.ValidationPropertyAttribute attribute must be applied to the control.

Все элементы управления проверки, за RequiredFieldValidator исключением элемента управления, пройдут проверку, если элемент управления ControlToValidate ввода, заданный свойством, не содержит текста.All validation controls, except the RequiredFieldValidator control, will pass validation if the input control specified by the ControlToValidate property contains no text. Если вы используете CustomValidator элемент управления, функции проверки на стороне клиента и на стороне сервера не вызываются.If you are using a CustomValidator control, the client-side and server-side validation functions are not called either.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

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

Дополнительно