Button.OnClientClick Eigenschaft

Definition

Ruft das clientseitige Skript ab, das ausgeführt wird, wenn für ein Button-Steuerelement ein Click-Ereignis ausgelöst wird, oder legt das clientseitige Skript fest.

public:
 virtual property System::String ^ OnClientClick { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string OnClientClick { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.OnClientClick : string with get, set
Public Overridable Property OnClientClick As String

Eigenschaftswert

Das clientseitige Skript, das ausgeführt wird, wenn für ein Button-Steuerelement ein Click-Ereignis ausgelöst wird.

Attribute

Beispiele

Für dieses Thema steht ein Visual Studio-Websiteprojekt mit Quellcode zur Verfügung: Download.

Im folgenden Codebeispiel wird veranschaulicht, wie die OnClientClick -Eigenschaft verwendet wird, um zusätzliche clientseitige Skripts anzugeben, die ausgeführt werden, wenn auf ein Button Steuerelement geklickt wird.

<%@ 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 Button1_Click (object sender, EventArgs e)
  {
    Label1.Text = "Thank you for visiting our site.";

  }
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="head1" runat="server">
    <title>Button.OnClientClick Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>Button.OnClientClick Example</h3> 
     
      
      <h4>Click to navigate to Microsoft.com:</h4>     
              
      <asp:button id="Button1"
       usesubmitbehavior="true"
       text="Open Web site"
       onclientclick="Navigate()"
       runat="server" onclick="Button1_Click" />
       
       <p></p>
      <asp:label id="Label1"
        runat="server">
      </asp:label>

    </form>
    
    <script type="text/javascript">
      function Navigate()
      {
        javascript:window.open("http://www.microsoft.com");
      }    
      
    </script>
</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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Label1.Text = "Thank you for visiting our site."
  End Sub
  
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="head1" runat="server">
    <title>Button.OnClientClick Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>Button.OnClientClick Example</h3> 
     
      
      <h4>Click to navigate to Microsoft.com:</h4>     
              
      <asp:button id="Button1"
       usesubmitbehavior="true"
       text="Open Web site"
       onclientclick="Navigate()"
       runat="server" onclick="Button1_Click" />
       
       <p></p>
      <asp:label id="Label1"
        runat="server">
      </asp:label>

    </form>
    
    <script type="text/javascript">
      function Navigate()
      {
        javascript:window.open("http://www.microsoft.com");
      }    
      
    </script>
</body>
</html>

Hinweise

Verwenden Sie die OnClientClick -Eigenschaft, um ein zusätzliches clientseitiges Skript anzugeben, das ausgeführt wird, wenn das Ereignis eines Button Steuerelements Click ausgelöst wird. Das Skript, das Sie für diese Eigenschaft angeben, wird im Attribut des Button Steuerelements OnClick zusätzlich zum vordefinierten clientseitigen Skript des Steuerelements gerendert.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen