HtmlInputButton.ValidationGroup Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.HtmlControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Sunucuya geri gönderildiğinde doğrulamaya HtmlInputButton neden olan denetim grubunu alır veya ayarlar.

public:
 virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };

public virtual string ValidationGroup { get; set; }

member this.ValidationGroup : string with get, set

Public Overridable Property ValidationGroup As String

Özellik Değeri

String

Denetimin sunucuya HtmlInputButton geri gönderildiğinde doğrulamaya neden olduğu denetim grubu. Varsayılan değer, bu özelliğin ayarlanmadığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir HtmlInputButton denetimin ValidationGroup sunucuya ne zaman geri göndereceğini doğrulamak üzere denetimleri belirtmek için özelliğinin nasıl kullanılacağını gösterir. Sayfada, kullanıcıdan veri yakalamak için iki metin kutusu ve kullanıcının bir metin kutusunu boş bırakmamasını sağlamak için iki RequiredFieldValidator denetim bulunur. İlk RequiredFieldValidator metin kutusunun denetimi doğrulama grubunda, CityInfoGroupRequiredFieldValidator ikinci kutunun denetimi ise doğrulama grubundadır StateInfoGroup . CityQueryButton öğesine tıklandığında, yalnızca doğrulama grubundaki CityInfoGroup denetim doğrulanır. StateQueryButton öğesine tıklandığında, yalnızca doğrulama grubundaki StateInfoGroup denetim doğrulanır.

<%@ 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 SubmitButton_Click(Object sender, EventArgs e)
  {

    // Determine which button was clicked.
    switch (((HtmlInputButton)sender).ID)
    {

      case "CityQueryButton":

        // Take the appropriate action if the controls pass validation. 
        if (CityReqValidator.IsValid)
        {
          Message.InnerHtml = "You have chosen to run a query for the following city: " +
             CityTextBox.Value;
        }

        break;

      case "StateQueryButton":

        // Take the appropriate action if the controls pass validation.
        if (StateReqValidator.IsValid)
        {
          Message.InnerHtml = "You have chosen to run a query for the following state: " +
             StateTextBox.Value;
        }

        break;

      default:

        // If the button clicked is not recognized, erase the message on the page.
        Message.InnerHtml = "";

        break;

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlInputButton ValidationGroup Example</title>
</head>

<body>

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

      <h3> HtmlInputButton ValidationGroup Example </h3>

      <table border="1" cellpadding="10">
         <tr>
            <td>
               <b>Enter city to query.</b> <br />
               <input id="CityTextBox" 
                      type="Text"
                      runat="server"/>
               <asp:RequiredFieldValidator ID="CityReqValidator"
                    ControlToValidate="CityTextBox"
                    ValidationGroup="CityInfoGroup"
                    ErrorMessage="<br />Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="CityQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="CityInfoGroup" 
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

         <tr>
            <td>
               <b>Enter state to query.</b> <br />
               <input id="StateTextBox" 
                      type="Text" 
                      runat="server"/>
               <asp:RequiredFieldValidator ID="StateReqValidator"
                    ControlToValidate="StateTextBox"
                    ValidationGroup="StateInfoGroup"
                    ErrorMessage="<br />Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="StateQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="StateInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

      </table>

      <br /><br />

      <span id="Message"
            runat="Server"/>


   </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
         
    ' Determine which button was clicked.
    Select Case (CType(sender, HtmlInputButton)).ID

      Case "CityQueryButton"

        ' Take the appropriate action if the controls pass validation. 
        If CityReqValidator.IsValid Then
           
          Message.InnerHtml = "You have chosen to run a query for the following city: " & _
             CityTextBox.Value
               
        End If

      Case "StateQueryButton"

        ' Take the appropriate action if the controls pass validation.
        If StateReqValidator.IsValid Then
               
          Message.InnerHtml = "You have chosen to run a query for the following state: " & _
             StateTextBox.Value
               
        End If

      Case Else

        ' If the button clicked is not recognized, erase the message on the page.
        Message.InnerHtml = ""

    End Select
        
  End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlInputButton ValidationGroup Example</title>
</head>

<body>
   <form id="form1" runat="server">
      <h3> HtmlInputButton ValidationGroup Example </h3>

      <table border="1" cellpadding="10">
         <tr>
            <td>
               <b>Enter city to query.</b> <br />
               <input id="CityTextBox" 
                      type="Text"
                      runat="server"/>
               <asp:RequiredFieldValidator ID="CityReqValidator"
                    ControlToValidate="CityTextBox"
                    ValidationGroup="CityInfoGroup"
                    ErrorMessage="<br />Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="CityQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="CityInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

         <tr>
            <td>
               <b>Enter state to query.</b> <br />
               <input id="StateTextBox" 
                      type="Text" 
                      runat="server"/>
               <asp:RequiredFieldValidator ID="StateReqValidator"
                    ControlToValidate="StateTextBox"
                    ValidationGroup="StateInfoGroup"
                    ErrorMessage="<br />Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="StateQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="StateInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

      </table>

      <br /><br />

      <span id="Message"
            runat="Server"/>


   </form>
</body>
</html>

Açıklamalar

Doğrulama grupları, sayfadaki doğrulama denetimlerini belirli bir kategoriye atamanızı sağlar. Her doğrulama grubu sayfadaki diğer doğrulama gruplarından bağımsız olarak doğrulanabilir. Denetimin ValidationGroup sunucuya geri gönderildiğinde doğrulamaya neden olduğu HtmlInputButton doğrulama grubunun adını belirtmek için özelliğini kullanın.

Bu özelliğin etkisi yalnızca özelliğin CausesValidation değeri olarak trueayarlandığında geçerlidir. özelliği için bir değer belirttiğinizde, denetim sunucuya ValidationGroup geri gönderildiğinde HtmlInputButton yalnızca belirtilen grubun parçası olan doğrulama denetimleri doğrulanır. Bu özellik için bir değer belirtmezseniz ve CausesValidation özellik olarak ayarlanırsa, denetim sunucuya truegeri gönderildiğinde sayfadaki bir doğrulama grubuna atanmamış tüm doğrulama denetimleri doğrulanır.

Şunlara uygulanır

Aracılığıyla paylaş

HtmlInputButton.ValidationGroup Özellik

Tanım

Özellik Değeri

Örnekler

Açıklamalar

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar