PostBackOptions Kelas

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan bagaimana JavaScript sisi klien dihasilkan untuk memulai peristiwa postback.

public ref class PostBackOptions sealed

public sealed class PostBackOptions

type PostBackOptions = class

Public NotInheritable Class PostBackOptions

Warisan: Object
PostBackOptions

Contoh

Contoh kode berikut menggunakan OnClick peristiwa Button kontrol untuk menghasilkan skrip sisi klien untuk HyperLink kontrol yang akan memungkinkan HyperLink kontrol menyebabkan peristiwa postback. ActionUrl Karena properti myPostBackOptions objek diatur ke "Page2.aspx", postback akan memposting halaman Formulir Web ke halaman lain bernama "Page2.aspx", yang tidak disediakan di sini. Untuk menggunakan contoh ini, Anda harus menambahkan halaman Web lain bernama "Page2.aspx" ke proyek atau direktori Anda.

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

Contoh kode berikut adalah halaman Web yang dapat digunakan untuk menjalankan file code-behind sebelumnya.

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

Keterangan

Kelas ini PostBackOptions memungkinkan kontrol untuk memancarkan skrip sisi klien yang memulai peristiwa postback. Kelas ini PostBackOptions juga menyediakan referensi ke kontrol yang memulai peristiwa postback melalui TargetControl properti . Peristiwa postback dibuat berdasarkan opsi yang ditentukan dalam objek yang PostBackOptions diteruskan ke ClientScriptManager.GetPostBackEventReference metode .

Biasanya, postback ke server dimulai oleh elemen seperti tombol Kirim atau tombol Gambar. Namun, dengan memancarkan JavaScript sisi klien, kontrol yang berbeda dapat memulai peristiwa postback.

Konstruktor

Nama	Deskripsi
PostBackOptions(Control, String, String, Boolean, Boolean, Boolean, Boolean, Boolean, String)	Menginisialisasi instans PostBackOptions baru kelas dengan nilai yang ditentukan untuk properti instans.
PostBackOptions(Control, String)	Menginisialisasi instans PostBackOptions baru kelas dengan kontrol target dan data argumen yang ditentukan.
PostBackOptions(Control)	Menginisialisasi instans PostBackOptions baru kelas dengan data kontrol target yang ditentukan.

Properti

Nama	Deskripsi
ActionUrl	Mendapatkan atau mengatur URL target untuk postback halaman Formulir Web.
Argument	Mendapatkan atau mengatur argumen opsional yang ditransfer dalam peristiwa postback.
AutoPostBack	Mendapatkan atau menetapkan nilai yang menunjukkan apakah formulir akan secara otomatis memposting kembali ke server sebagai respons terhadap tindakan pengguna.
ClientSubmit	Mendapatkan atau menetapkan nilai yang menunjukkan apakah peristiwa postback harus terjadi dari skrip sisi klien.
PerformValidation	Mendapatkan atau menetapkan nilai yang menunjukkan apakah validasi sisi klien diperlukan sebelum peristiwa postback terjadi.
RequiresJavaScriptProtocol	Mendapatkan atau menetapkan nilai yang menunjukkan apakah `javascript:` awalan dihasilkan untuk skrip sisi klien.
TargetControl	Mendapatkan target kontrol yang menerima peristiwa postback.
TrackFocus	Mendapatkan atau menetapkan nilai yang menunjukkan apakah peristiwa postback harus mengembalikan halaman ke posisi gulir saat ini dan mengembalikan fokus ke kontrol saat ini.
ValidationGroup	Mendapatkan atau mengatur grup kontrol yang PostBackOptions objeknya menyebabkan validasi saat memposting kembali ke server.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Lihat juga

GetPostBackEventReference(PostBackOptions)

Saran dan Komentar

Apakah halaman ini membantu?