Bagikan melalui

AsyncPostBackTrigger Kelas

  • Referensi

Definisi

Ruang nama:
System.Web.UI
Rakitan:
System.Web.Extensions.dll

Menentukan kontrol dan peristiwa opsional kontrol sebagai pemicu kontrol postback asinkron yang menyebabkan UpdatePanel kontrol disegarkan.

public ref class AsyncPostBackTrigger : System::Web::UI::UpdatePanelControlTrigger
public class AsyncPostBackTrigger : System.Web.UI.UpdatePanelControlTrigger
type AsyncPostBackTrigger = class
    inherit UpdatePanelControlTrigger
Public Class AsyncPostBackTrigger
Inherits UpdatePanelControlTrigger
Warisan
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

Contoh

Contoh berikut menunjukkan cara menambahkan AsyncPostBackTrigger kontrol secara deklaratif. Button Kontrol yang berada di luar UpdatePanel kontrol memungkinkan pengguna memasukkan istilah pencarian untuk ditemukan dalam Products tabel database Northwind. GridView Kontrol yang ada di UpdatePanel dalam kontrol menunjukkan hasilnya. Button Kontrol ditentukan sebagai pemicu asinkron untuk UpdatePanel kontrol.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    protected void Button1_Click(object sender, EventArgs e)
    {
        SqlDataSource1.SelectParameters["SearchTerm"].DefaultValue = 
            Server.HtmlEncode(TextBox1.Text);
        Label1.Text = "Searching for '" + 
            Server.HtmlEncode(TextBox1.Text) + "'";
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>AsyncPostBackTrigger Example</title>
</head>
<body>
    <form id="form1" defaultbutton="Button1"
          defaultfocus="TextBox1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" runat="server" />
            <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
            <asp:Button ID="Button1" Text="Submit" 
                        OnClick="Button1_Click" runat="server"  />
            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" 
                             runat="server">
                <Triggers>
                  <asp:AsyncPostBackTrigger ControlID="Button1" />
                </Triggers>
                <ContentTemplate>
                    <hr />
                    <asp:Label ID="Label1" runat="server"/>
                    <br />
                    <asp:GridView ID="GridView1" runat="server" AllowPaging="True"
                        AllowSorting="True"
                        DataSourceID="SqlDataSource1">
                        <EmptyDataTemplate>
                        Enter a search term.
                        </EmptyDataTemplate>
                    </asp:GridView>
                    <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
                        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                        SelectCommand="SELECT [ProductName], [UnitsInStock] FROM 
                        [Alphabetical list of products] WHERE ([ProductName] LIKE 
                        '%' + @SearchTerm + '%')">
                        <SelectParameters>
                            <asp:Parameter Name="SearchTerm" Type="String" />
                        </SelectParameters>
                    </asp:SqlDataSource>
                </ContentTemplate>
            </asp:UpdatePanel>
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        SqlDataSource1.SelectParameters("SearchTerm").DefaultValue = _
            Server.HtmlEncode(TextBox1.Text)
        Label1.Text = "Searching for '" & _
            Server.HtmlEncode(TextBox1.Text) & "'"

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>AsyncPostBackTrigger Example</title>
</head>
<body>
    <form id="form1" defaultbutton="Button1"
          defaultfocus="TextBox1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" runat="server" />
            <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
            <asp:Button ID="Button1" Text="Submit" 
                        OnClick="Button1_Click" runat="server"  />
            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" 
                             runat="server">
                <Triggers>
                  <asp:AsyncPostBackTrigger ControlID="Button1" />
                </Triggers>
                <ContentTemplate>
                    <hr />
                    <asp:Label ID="Label1" runat="server"/>
                    <br />
                    <asp:GridView ID="GridView1" runat="server" AllowPaging="True"
                        AllowSorting="True"
                        DataSourceID="SqlDataSource1">
                        <EmptyDataTemplate>
                        Enter a search term.
                        </EmptyDataTemplate>
                    </asp:GridView>
                    <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
                        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                        SelectCommand="SELECT [ProductName], [UnitsInStock] FROM 
                        [Alphabetical list of products] WHERE ([ProductName] LIKE 
                        '%' + @SearchTerm + '%')">
                        <SelectParameters>
                            <asp:Parameter Name="SearchTerm" Type="String" />
                        </SelectParameters>
                    </asp:SqlDataSource>
                </ContentTemplate>
            </asp:UpdatePanel>
        </div>
    </form>
</body>
</html>

Keterangan

AsyncPostBackTrigger Gunakan kontrol untuk mengaktifkan kontrol menjadi pemicu UpdatePanel kontrol. Kontrol yang merupakan pemicu panel pembaruan menyebabkan refresh konten panel setelah postback asinkron. Menentukan kontrol pemicu asinkron berguna dalam skenario berikut:

  • Untuk kontrol yang berada di luar panel.

  • Untuk kontrol yang berada di dalam panel saat ChildrenAsTriggers properti adalah false.

  • Untuk kontrol yang berada di dalam panel berlapis, untuk menyebabkan refresh panel induk.

Kontrol yang AsyncPostBackTrigger dirujuk kontrol harus berada dalam kontainer penamaan yang sama dengan panel pembaruan yang merupakan pemicunya. Pemicu yang didasarkan pada kontrol dalam kontainer penamaan lain tidak didukung.

Tambahkan AsyncPostBackTrigger kontrol baik dengan menggunakan kotak dialog Editor Koleksi UpdatePanelTrigger di perancang atau dengan membuat Triggers elemen secara deklaratif dalam UpdatePanel kontrol. Properti ControlID diperlukan, tetapi EventName properti bersifat opsional. EventName Jika properti tidak ditentukan, DefaultEventAttribute atribut kontrol digunakan untuk menentukan peristiwa default. Misalnya, peristiwa default untuk Button kontrol adalah Click peristiwa . Properti EventName tidak peka huruf besar/kecil.

Anda juga dapat mereferensikan kontainer penamaan sebagai pemicu. Dalam hal ini, semua kontrol anak dalam kontainer yang menyebabkan postback dianggap sebagai pemicu untuk UpdatePanel kontrol.

Penambahan AsyncPostBackTrigger kontrol secara terprogram tidak didukung. Untuk mendaftarkan kontrol postback secara terprogram, gunakan RegisterAsyncPostBackControl metode ScriptManager kontrol. Kemudian panggil Update metode UpdatePanel kontrol saat kontrol memposting kembali.

Jika Anda menentukan kontrol menggunakan PostBackTrigger dan AsyncPostBackTrigger, pengecualian akan dilemparkan.

Konstruktor

AsyncPostBackTrigger()

Menginisialisasi instans AsyncPostBackTrigger baru kelas.

Properti

ControlID

Mendapatkan atau mengatur nama kontrol yang memicu postback asinkron untuk UpdatePanel kontrol.
EventName

Mendapatkan atau mengatur peristiwa kontrol postback yang memicu UpdatePanel kontrol untuk diperbarui.
Owner

Mendapatkan referensi ke UpdatePanel kontrol yang ditargetkan UpdatePanelTrigger .

(Diperoleh dari UpdatePanelTrigger)

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindTargetControl(Boolean)

Mencari kontrol yang ditentukan dalam ControlID properti .

(Diperoleh dari UpdatePanelControlTrigger)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
HasTriggered()

Mengembalikan nilai yang menunjukkan apakah pemicu dipanggil.
Initialize()

Menginisialisasi AsyncPostBackTrigger kontrol dan menentukan apakah peristiwa yang dinamai dalam pemicu ada dan valid.
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
OnEvent(Object, EventArgs)

Menaikkan peristiwa yang akan memicu postback dan refresh UpdatePanel kontrol.
ToString()

Mengembalikan representasi string dari kontrol saat ini AsyncPostBackTrigger .

Berlaku untuk

Lihat juga