PostBackOptions Klasse

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
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 ActionUrl Eigenschaft des myPostBackOptions Objekts auf "Page2.aspx" festgelegt ist, postet der Postback die Web Forms-Seite auf eine andere Seite namens "Page2.aspx", die hier nicht bereitgestellt wird. Um dieses Beispiel zu verwenden, müssen Sie ihrem Projekt oder Verzeichnis eine weitere Webseite mit dem Namen "Page2.aspx" 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

Das folgende Codebeispiel ist 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 ausgeben, die ein Postbackereignis initiieren. Die PostBackOptions Klasse stellt auch einen Verweis auf das Steuerelement bereit, das das Postbackereignis über die TargetControl Eigenschaft initiiert hat. Das Postbackereignis wird basierend auf den optionen erstellt, die im Objekt angegeben sind, das PostBackOptions an die ClientScriptManager.GetPostBackEventReference Methode übergeben wird.

Normalerweise wird ein Postback auf dem Server durch Elemente wie eine Absenden-Schaltfläche oder eine Bildschaltfläche initiiert. Durch das Senden von clientseitigem JavaScript können unterschiedliche Steuerelemente jedoch ein Postbackereignis initiieren.

Konstruktoren

Name	Beschreibung
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.
PostBackOptions(Control, String)	Initialisiert eine neue Instanz der PostBackOptions Klasse mit den angegebenen Zielsteuerelement- und Argumentdaten.
PostBackOptions(Control)	Initialisiert eine neue Instanz der PostBackOptions Klasse mit den angegebenen Zielsteuerelementdaten.

Eigenschaften

Name	Beschreibung
ActionUrl	Dient zum Abrufen oder Festlegen der Ziel-URL für das Postback einer Web Forms-Seite.
Argument	Ruft ein optionales Argument ab, das im Postbackereignis übertragen wird, oder legt dieses fest.
AutoPostBack	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Formular als Reaktion auf eine Benutzeraktion automatisch auf den Server zurückgibt.
ClientSubmit	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Postbackereignis aus clientseitigem Skript erfolgen soll.
PerformValidation	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine clientseitige Überprüfung erforderlich ist, bevor das Postbackereignis auftritt.
RequiresJavaScriptProtocol	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das `javascript:` Präfix für das clientseitige Skript generiert wird.
TargetControl	Ruft das Steuerelementziel ab, das das Postbackereignis empfängt.
TrackFocus	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Postbackereignis die Seite an die aktuelle Bildlaufposition zurückgeben und den Fokus auf das aktuelle Steuerelement zurückgeben soll.
ValidationGroup	Dient zum Abrufen oder Festlegen der Gruppe von Steuerelementen, für die das PostBackOptions Objekt eine Überprüfung verursacht, wenn es wieder auf dem Server veröffentlicht wird.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Weitere Informationen

GetPostBackEventReference(PostBackOptions)

Feedback

War diese Seite hilfreich?