AsyncPostBackTrigger Kelas
Definisi
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 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
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk