Freigeben über


PostBackOptions Klasse

Definition

Gibt an, wie clientseitiges JavaScript generiert wird, um ein Postbackereignis zu initiieren.

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
Vererbung
PostBackOptions

Beispiele

Im folgenden Codebeispiel wird das OnClick Ereignis eines Button Steuerelements verwendet, um clientseitige Skripts für ein HyperLink Steuerelement zu generieren, das es dem HyperLink Steuerelement ermöglicht, ein Postbackereignis zu verursachen. Da die Eigenschaft des myPostBackOptions Objekts auf "Page2.aspx" festgelegt ist, wird der ActionUrl Postback die Web Forms Seite auf eine andere Seite namens "Page2.aspx" posten, die hier nicht angegeben wird. Um dieses Beispiel zu verwenden, müssen Sie einer anderen Webseite namens "Page2.aspx" Ihrem Projekt oder Verzeichnis hinzufügen.

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class postbackoptionscs : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (Page.IsPostBack)
        {
            Label1.Text = "A postback event has occurred.";
        }
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Create a new PostBackOptions object and set its properties.
        PostBackOptions myPostBackOptions = new PostBackOptions(this);
        myPostBackOptions.ActionUrl = "Page2.aspx";
        myPostBackOptions.AutoPostBack = false;
        myPostBackOptions.RequiresJavaScriptProtocol = true;
        myPostBackOptions.PerformValidation = true;

        // Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions);

        Label1.Text = "Click this hyperlink to initiate a postback event.";
    }
}
Partial Class postbackoptionsvb
    Inherits System.Web.UI.Page
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

        ' Create a new PostBackOptions object and set its properties.
        Dim myPostBackOptions As PostBackOptions = New PostBackOptions(Me)
        myPostBackOptions.ActionUrl = "Page2.aspx"
        myPostBackOptions.AutoPostBack = False
        myPostBackOptions.RequiresJavaScriptProtocol = True
        myPostBackOptions.PerformValidation = True

        ' Add the client-side script to the HyperLink1 control.
        HyperLink1.NavigateUrl = Page.ClientScript.GetPostBackEventReference(myPostBackOptions)

        Label1.Text = "Click this hyperlink to initiate a postback event."

    End Sub

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load

        If Page.IsPostBack Then
            Label1.Text = "A postback event has occurred."
        End If

    End Sub
End Class

Im folgenden Codebeispiel handelt es sich um eine Webseite, die zum Ausführen der vorherigen Codebehind-Datei verwendet werden kann.

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="postbackoptions.aspx.cs" Inherits="postbackoptionscs" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text="">
      </asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback">
      </asp:HyperLink>
    </form>
  </body>
</html>
<%@ Page Language="VB" AutoEventWireup="true" CodeFile="postbackoptions.aspx.vb" Inherits="postbackoptionsvb" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>PostBackOptions Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
    <h3>PostBackOptions Example Page</h3>
      Click this button to create client-side script for the 
      Postback hyperlink that causes a postback event to occur.
      <br />
      <asp:Button id="Button1" 
        runat="server" 
        text="Create Script" 
        onclick="Button1_Click" />
      <br /><br />
      <asp:Label id="Label1" 
        runat="server" 
        text=""></asp:Label>
      <br />
      <asp:HyperLink id="HyperLink1" 
        runat="server" 
        text="Postback"></asp:HyperLink>
      <br />
    </form>
  </body>
</html>

Hinweise

Mit der PostBackOptions Klasse können Steuerelemente clientseitige Skripts senden, die ein Postbackereignis initiieren. Die PostBackOptions Klasse enthält auch einen Verweis auf das Steuerelement, das das Postbackereignis durch die TargetControl Eigenschaft initiiert hat. Das Postbackereignis wird basierend auf den in der PostBackOptions Methode übergebenen ClientScriptManager.GetPostBackEventReference Objektoptionen erstellt.

Normalerweise wird ein Postback auf dem Server durch Elemente wie eine Schaltfläche "Senden" oder eine Schaltfläche "Bild" initiiert. Durch das Senden clientseitiger JavaScript-Steuerelemente kann jedoch ein Postbackereignis initiiert werden.

Konstruktoren

PostBackOptions(Control)

Initialisiert eine neue Instanz der PostBackOptions-Klasse mit den angegebenen Zielsteuerelement-Daten.

PostBackOptions(Control, String)

Initialisiert eine neue Instanz der PostBackOptions-Klasse mit dem angegebenen Zielsteuerelement und den angegebenen Argumentdaten.

PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

Initialisiert eine neue Instanz der PostBackOptions-Klasse mit den angegebenen Werten für die Eigenschaften der Instanz.

Eigenschaften

ActionUrl

Ruft die Ziel-URL für das Postback einer Web Forms-Seite ab oder legt diese fest.

Argument

Ruft ein optionales Argument ab, das im Postbackereignis übertragen wird, oder legt dieses fest.

AutoPostBack

Ruft einen Wert ab, der angibt, ob das Formular automatisch als Antwort auf eine Benutzeraktion ein Postback an den Server ausführt.

ClientSubmit

Ruft einen Wert ab, der angibt, ob das Postbackereignis vom clientseitigem Skript aus ausgeführt werden soll, oder legt diesen fest.

PerformValidation

Ruft einen Wert ab, der angibt, ob vor dem Auftreten des Postbackereignisses die clientseitige Validierung erforderlich ist, oder legt diesen fest.

RequiresJavaScriptProtocol

Ruft einen Wert ab, der angibt, ob das javascript:-Präfix für das clientseitige Skript generiert wird, oder legt diesen fest.

TargetControl

Ruft das Steuerelementziel ab, von dem das Postbackereignis empfangen wird.

TrackFocus

Ruft einen Wert ab, der angibt, ob das Postbackereignis die Seite auf die aktuelle Bildlaufposition und den Fokus auf das aktuelle Steuerelement zurücksetzen soll, oder legt diesen fest.

ValidationGroup

Ruft die Gruppe von Steuerelementen ab, für die das PostBackOptions-Objekt eine Validierung auslöst, wenn ein Postback an den Server ausgeführt wird, oder legt diese fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für

Siehe auch