PostBackOptions 類別

  • 參考

定義

命名空間:
System.Web.UI
組件:
System.Web.dll

指定用戶端 JavaScript 的產生方式，以啟始回傳事件。

public ref class PostBackOptions sealed
public sealed class PostBackOptions
type PostBackOptions = class
Public NotInheritable Class PostBackOptions
繼承
Object
PostBackOptions

範例

下列程式碼範例會使用 OnClick 控制項的 事件來產生控制項的 Button 用戶端腳本 HyperLink ，以允許 HyperLink 控制項造成回傳事件。 ActionUrl由於 物件的 屬性 myPostBackOptions 設定為 「Page2.aspx」，所以回傳會將Web Form頁面張貼至另一個名為 「Page2.aspx」 的頁面，此處未提供。 若要使用此範例，您必須將名為 「Page2.aspx」 的另一個網頁新增至您的專案或目錄。

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

下列程式碼範例是可用來執行上述程式碼後置檔案的網頁。

<%@ 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>

備註

類別 PostBackOptions 可讓控制項發出起始回傳事件的用戶端腳本。 類別 PostBackOptions 也提供透過 屬性起始回傳事件的 TargetControl 控制項參考。 回傳事件是根據傳入 方法 ClientScriptManager.GetPostBackEventReference 之 PostBackOptions 物件中指定的選項所建立。

一般而言，回傳至伺服器是由 [提交] 按鈕或 [影像] 按鈕等元素起始。 不過，藉由發出用戶端 JavaScript，不同的控制項可以起始回傳事件。

建構函式

PostBackOptions(Control)

使用指定的目標控制項資料，初始化 PostBackOptions 類別的新執行個體。
PostBackOptions(Control, String)

使用指定的目標控制項和引數資料，初始化 PostBackOptions 類別的新執行個體。
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)

使用執行個體之指定的屬性值，初始化 PostBackOptions 類別的新執行個體。

屬性

ActionUrl

取得或設定 Web Form 網頁回傳的目標 URL。
Argument

取得或設定回傳事件中所傳輸的選擇性引數。
AutoPostBack

取得或設定值，指出表單是否會自動回傳至伺服器以回應使用者動作。
ClientSubmit

取得或設定值，指出回傳事件是否應該從用戶端指令碼發生。
PerformValidation

取得或設定值，指出回傳事件發生之前是否需要用戶端驗證。
RequiresJavaScriptProtocol

取得或設定值，指出是否產生用戶端指令碼的 javascript: 前置字元。
TargetControl

取得會接收回傳事件的目標控制項。
TrackFocus

取得或設定值，指出回傳事件是否應該將頁面傳回至目前捲動位置，並將焦點傳回至目前的控制項。
ValidationGroup

取得或設定控制項群組，PostBackOptions 物件會在回傳至伺服器時，針對這個群組引發驗證。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱