HtmlInputCheckBox.ServerChange-Ereignis

Artikel
08/20/2007

Tritt ein, wenn die Webseite an den Server gesendet wird und sich der Zustand des HtmlInputCheckBox-Steuerelements seit der letzten Übermittlung geändert hat.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Event ServerChange As EventHandler
'Usage
Dim instance As HtmlInputCheckBox
Dim handler As EventHandler

AddHandler instance.ServerChange, handler

public event EventHandler ServerChange

public:
event EventHandler^ ServerChange {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

/** @event */
public void add_ServerChange (EventHandler value)

/** @event */
public void remove_ServerChange (EventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Dieses Ereignis wird ausgelöst, wenn die Webseite an den Server gesendet wird und sich der Zustand des HtmlInputCheckBox-Steuerelements seit der letzten Übermittlung geändert hat.

Hinweis

Der Ansichtszustand für das Steuerelement muss aktiviert sein, damit das ServerChange-Ereignis ordnungsgemäß funktioniert.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Im folgenden Codebeispiel wird das Angeben und Codieren eines Handlers für das ServerChange-Ereignis veranschaulicht.

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

<html>
<head>

   <script language="VB" runat="server">

    Sub Button1_Click(sender As Object, e As EventArgs)
        
        If Prev_Check_State.InnerHtml = Check1.Checked.ToString() Then
            Span2.InnerHtml = "CheckBox1 did not change state between clicks."
        End If 
        If Check1.Checked = True Then
            Span1.InnerHtml = "CheckBox1 is selected!"
            Prev_Check_State.InnerHtml = "True"
        Else
            Span1.InnerHtml = "CheckBox1 is not selected!"
            Prev_Check_State.InnerHtml = "False"
        End If
    End Sub 'Button1_Click
     

    Sub Server_Changed(sender As Object, e As EventArgs)
        Span2.InnerHtml = "CheckBox1 changed state between clicks."
    End Sub 'Server_Changed

  </script>

</head>

<body>

   <h3>HtmlInputCheckBox Sample</h3>

   <form runat=server>

      <input id="Check1" 
             type="checkbox"
             OnServerChange="Server_Changed" 
             runat="server"/> 
 
      CheckBox1 &nbsp;&nbsp;

      <span id="Span1" 
            style="color:red" 
            runat="server"/>

      <p>

      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server"/>
      
      <br><br>

      <span id="Span2" 
            runat="server"/>

      <htmlinputhidden id="Prev_Check_State"
                       Visible="false"
                       runat="server"/>

   </form>

</body>
</html>

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

<html>
<head>

   <script language="C#" runat="server">

      void Button1_Click(object sender, EventArgs e) 
      { 

         if (Prev_Check_State.InnerHtml == Check1.Checked.ToString())
            Span2.InnerHtml = "CheckBox1 did not change state between clicks.";

         if (Check1.Checked == true)
         {          
            Span1.InnerHtml = "CheckBox1 is selected!";
            Prev_Check_State.InnerHtml="True";
         }         
         else
         { 
            Span1.InnerHtml = "CheckBox1 is not selected!";
            Prev_Check_State.InnerHtml="False";
         }
         
      }

      void Server_Changed(object sender, EventArgs e) 
      {
         Span2.InnerHtml = "CheckBox1 changed state between clicks.";
      }

   </script>

</head>

<body>

   <h3>HtmlInputCheckBox Sample</h3>

   <form runat=server>

      <input id="Check1" 
             type="checkbox"
             OnServerChange="Server_Changed" 
             runat="server"/> 
 
      CheckBox1 &nbsp;&nbsp;

      <span id="Span1" 
            style="color:red" 
            runat="server"/>

      <p>

      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server"/>
      
      <br><br>

      <span id="Span2" 
            runat="server"/>

      <htmlinputhidden id="Prev_Check_State"
                       Visible="false"
                       runat="server"/>

   </form>

</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
<head>

   <script language="JSCRIPT" runat="server">

    function Button1_Click(sender : Object, e : EventArgs){
        
        if(Prev_Check_State.InnerHtml == Check1.Checked.ToString())
            Span2.InnerHtml = "CheckBox1 did not change state between clicks."
        if(Check1.Checked){
            Span1.InnerHtml = "CheckBox1 is selected!"
            Prev_Check_State.InnerHtml = "True"
        }else{
            Span1.InnerHtml = "CheckBox1 is not selected!"
            Prev_Check_State.InnerHtml = "False"
        }
    }

    function Server_Changed(sender : Object, e : EventArgs){
        Span2.InnerHtml = "CheckBox1 changed state between clicks."
    }

  </script>

</head>

<body>

   <h3>HtmlInputCheckBox Sample</h3>

   <form runat=server>

      <input id="Check1" 
             type="checkbox"
             OnServerChange="Server_Changed" 
             runat="server"/> 
 
      CheckBox1 &nbsp;&nbsp;

      <span id="Span1" 
            style="color:red" 
            runat="server"/>

      <p>

      <input type="button" 
             id="Button1" 
             value="Enter" 
             OnServerClick="Button1_Click" 
             runat="server"/>
      
      <br><br>

      <span id="Span2" 
            runat="server"/>

      <htmlinputhidden id="Prev_Check_State"
                       Visible="false"
                       runat="server"/>

   </form>

</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlInputCheckBox-Klasse
HtmlInputCheckBox-Member
System.Web.UI.HtmlControls-Namespace
OnServerChange

Weitere Ressourcen

HTML-Serversteuerelemente

Freigeben über