HtmlInputButton.ValidationGroup Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.HtmlControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur grup kontrol yang HtmlInputButton menyebabkan validasi saat memposting kembali ke server.

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

Nilai Properti

String

Grup kontrol yang kontrolnya HtmlInputButton menyebabkan validasi ketika memposting kembali ke server. Nilai default adalah string kosong (""), yang menunjukkan bahwa properti ini tidak diatur.

Contoh

Contoh kode berikut menunjukkan cara menggunakan ValidationGroup properti untuk menentukan kontrol yang akan divalidasi saat HtmlInputButton kontrol memposting kembali ke server. Halaman berisi dua kotak teks untuk mengambil data dari pengguna dan dua RequiredFieldValidator kontrol untuk memastikan bahwa pengguna tidak membiarkan kotak teks kosong. Kontrol RequiredFieldValidator untuk kotak teks pertama berada dalam CityInfoGroup grup validasi dan RequiredFieldValidator kontrol untuk kotak kedua berada dalam StateInfoGroup grup validasi. CityQueryButton Saat diklik, hanya kontrol dalam grup validasi yang CityInfoGroup divalidasi. StateQueryButton Saat diklik, hanya kontrol dalam grup validasi yang StateInfoGroup divalidasi.

<%@ 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>

Keterangan

Grup validasi memungkinkan Anda menetapkan kontrol validasi pada halaman ke kategori tertentu. Setiap grup validasi dapat divalidasi secara independen dari grup validasi lain di halaman. ValidationGroup Gunakan properti untuk menentukan nama grup validasi yang HtmlInputButton kontrolnya menyebabkan validasi saat memposting kembali ke server.

Properti ini hanya berpengaruh ketika nilai CausesValidation properti diatur ke true. Saat Anda menentukan nilai untuk ValidationGroup properti , hanya kontrol validasi yang merupakan bagian dari grup yang ditentukan yang divalidasi ketika HtmlInputButton posting kontrol kembali ke server. Jika Anda tidak menentukan nilai untuk properti ini dan CausesValidation properti diatur ke true, semua kontrol validasi pada halaman yang tidak ditetapkan ke grup validasi divalidasi ketika posting kontrol kembali ke server.

Berlaku untuk

Bagikan melalui