PostBackOptions 類別

參考

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

指定用戶端 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)

適用於

另請參閱

GetPostBackEventReference(PostBackOptions)

共用方式為

PostBackOptions 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

其他資源