PostBackOptions PostBackOptions PostBackOptions PostBackOptions Class

Definition

Gibt an, wie clientseitiges JavaScript generiert wird, um ein Postbackereignis zu initiieren.Specifies how client-side JavaScript is generated to initiate a postback event.

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

Beispiele

Im folgenden Codebeispiel wird das OnClick -Ereignis Button eines-Steuer Elements verwendet, um ein Client seitiges HyperLink Skript für ein Steuerelement HyperLink zu generieren, das es dem-Steuerelement ermöglicht, ein Post Back Ereignis auszulösen.The following code example uses the OnClick event of a Button control to generate client-side script for a HyperLink control that will allow the HyperLink control to cause a postback event. Da die ActionUrl -Eigenschaft myPostBackOptions des-Objekts auf "Page2. aspx" festgelegt ist, sendet das Postback die Web Forms Seite auf eine andere Seite mit dem Namen "Page2. aspx", die hier nicht angegeben wird.Because the ActionUrl property of the myPostBackOptions object is set to "Page2.aspx", the postback will post the Web Forms page to another page named "Page2.aspx", which is not provided here. Um dieses Beispiel zu verwenden, müssen Sie Ihrem Projekt oder Verzeichnis eine weitere Webseite mit dem Namen "Page2. aspx" hinzufügen.To use this example, you must add another Web page named "Page2.aspx" to your project or directory.

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

Das folgende Codebeispiel ist eine Webseite, die zum Ausführen der vorangehenden Code Behind-Datei verwendet werden kann.The following code example is a Web page that can be used to run the preceding code-behind file.

<%@ 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 PostBackOptions der-Klasse können Steuerelemente Client seitiges Skript ausgeben, das ein Post Back Ereignis auslöst.The PostBackOptions class allows controls to emit client-side script that initiates a postback event. Die PostBackOptions -Klasse stellt auch einen Verweis auf das-Steuerelement bereit, das das Post TargetControl Back Ereignis durch die-Eigenschaft initiiert hat.The PostBackOptions class also provides a reference to the control that initiated the postback event through the TargetControl property. Das Post Back Ereignis wird auf der Grundlage der Optionen erstellt, die PostBackOptions im-Objekt angegeben sind ClientScriptManager.GetPostBackEventReference , das an die-Methode weitergegeben wird.The postback event is created based on the options specified in the PostBackOptions object passed in to the ClientScriptManager.GetPostBackEventReference method.

Normalerweise wird ein Postback an den Server durch Elemente wie z. b. eine Schaltfläche "Senden" oder eine Bild Schaltfläche initiiert.Normally, a postback to the server is initiated by elements such as a Submit button or an Image button. Wenn Sie jedoch Client seitiges JavaScript ausgeben, können verschiedene Steuerelemente ein Post Back Ereignis initiieren.However, by emitting client-side JavaScript, different controls can initiate a postback event.

Konstruktoren

PostBackOptions(Control) PostBackOptions(Control) PostBackOptions(Control) PostBackOptions(Control)

Initialisiert eine neue Instanz der PostBackOptions-Klasse mit den angegebenen Zielsteuerelement-Daten.Initializes a new instance of the PostBackOptions class with the specified target control data.

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

Initialisiert eine neue Instanz der PostBackOptions-Klasse mit dem angegebenen Zielsteuerelement und den angegebenen Argumentdaten.Initializes a new instance of the PostBackOptions class with the specified target control and argument data.

PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String) 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.Initializes a new instance of the PostBackOptions class with the specified values for the instance's properties.

Eigenschaften

ActionUrl ActionUrl ActionUrl ActionUrl

Ruft die Ziel-URL für das Postback einer Web Forms-Seite ab oder legt diese fest.Gets or sets the target URL for the postback of a Web Forms page.

Argument Argument Argument Argument

Ruft ein optionales Argument ab, das im Postbackereignis übertragen wird, oder legt dieses fest.Gets or sets an optional argument that is transferred in the postback event.

AutoPostBack AutoPostBack AutoPostBack AutoPostBack

Ruft einen Wert ab, der angibt, ob das Formular automatisch als Antwort auf eine Benutzeraktion ein Postback an den Server ausführt.Gets or sets a value that indicates whether the form will automatically post back to the server in response to a user action.

ClientSubmit ClientSubmit ClientSubmit ClientSubmit

Ruft einen Wert ab, der angibt, ob das Postbackereignis vom clientseitigem Skript aus ausgeführt werden soll, oder legt diesen fest.Gets or sets a value indicating whether the postback event should occur from client-side script.

PerformValidation PerformValidation PerformValidation PerformValidation

Ruft einen Wert ab, der angibt, ob vor dem Auftreten des Postbackereignisses die clientseitige Validierung erforderlich ist, oder legt diesen fest.Gets or sets a value indicating whether client-side validation is required before the postback event occurs.

RequiresJavaScriptProtocol RequiresJavaScriptProtocol RequiresJavaScriptProtocol RequiresJavaScriptProtocol

Ruft einen Wert ab, der angibt, ob das javascript:-Präfix für das clientseitige Skript generiert wird, oder legt diesen fest.Gets or sets a value indicating whether the javascript: prefix is generated for the client-side script.

TargetControl TargetControl TargetControl TargetControl

Ruft das Steuerelementziel ab, von dem das Postbackereignis empfangen wird.Gets the control target that receives the postback event.

TrackFocus TrackFocus TrackFocus 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.Gets or sets a value indicating whether the postback event should return the page to the current scroll position and return focus to the current control.

ValidationGroup ValidationGroup ValidationGroup 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.Gets or sets the group of controls for which the PostBackOptions object causes validation when it posts back to the server.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch