Aracılığıyla paylaş


AsyncPostBackTrigger Sınıf

Tanım

Denetimin bir denetimini ve isteğe bağlı olayını, denetimin yenilenmesine neden UpdatePanel olan zaman uyumsuz bir geri gönderme denetimi tetikleyicisi olarak tanımlar.

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
Devralma

Örnekler

Aşağıdaki örnekte, bildirim temelli olarak bir AsyncPostBackTrigger denetimin nasıl ekleneceği gösterilmektedir. Denetimin Button dışındaki bir UpdatePanel denetim, kullanıcıların Northwind veritabanının Products tablosunda bulmak için bir arama terimi girmesini sağlar. GridView Denetimin içindeki UpdatePanel denetim sonuçları gösterir. Denetim Button , denetim için UpdatePanel zaman uyumsuz tetikleyici olarak belirtilir.

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

Açıklamalar

Denetimlerin AsyncPostBackTrigger bir UpdatePanel denetim için tetikleyici olmasını sağlamak için denetimi kullanın. Güncelleştirme panelinin tetikleyicileri olan denetimler, zaman uyumsuz geri gönderme sonrasında panelin içeriğinin yenilenmesine neden olur. Zaman uyumsuz tetikleyici denetimi tanımlamak aşağıdaki senaryolarda yararlıdır:

  • Panelin dışındaki denetimler için.

  • özelliği falseolduğunda panelin ChildrenAsTriggers içindeki denetimler için.

  • İç içe panellerin içindeki denetimler için, üst panellerin yenilenmesine neden olmak için.

Denetimin AsyncPostBackTrigger başvuracağı denetim, tetikleyici olduğu güncelleştirme paneliyle aynı adlandırma kapsayıcısında olmalıdır. Diğer adlandırma kapsayıcılarındaki denetimleri temel alan tetikleyiciler desteklenmez.

Tasarımcıda UpdatePanelTrigger Koleksiyon Düzenleyicisi iletişim kutusunu kullanarak veya denetimde bildirim temelli olarak UpdatePanel bir Triggers öğe oluşturarak denetimler ekleyinAsyncPostBackTrigger. ControlID özelliği gereklidir, ancak EventName özelliği isteğe bağlıdır. EventName Özellik belirtilmezse, DefaultEventAttribute varsayılan olayı belirlemek için denetimin özniteliği kullanılır. Örneğin, denetimin Button varsayılan olayı olaydır Click . EventName özelliği büyük/küçük harfe duyarlı değildir.

Bir adlandırma kapsayıcısı tetikleyici olarak da başvurabilirsiniz. Bu durumda, kapsayıcıdaki geri göndermeye neden olan tüm alt denetimler denetim için UpdatePanel tetikleyici olarak kabul edilir.

Program aracılığıyla denetim ekleme AsyncPostBackTrigger desteklenmez. Bir geri gönderme denetimini program aracılığıyla kaydetmek için denetimin RegisterAsyncPostBackControlScriptManager yöntemini kullanın. Ardından denetim geri gönderildiğinde denetimin yöntemini UpdatePanel çağırınUpdate.

hem AsyncPostBackTriggerhem de PostBackTrigger kullanarak bir denetim tanımlarsanız, bir özel durum oluşturulur.

Oluşturucular

AsyncPostBackTrigger()

Sınıfın yeni bir AsyncPostBackTrigger örneğini başlatır.

Özellikler

ControlID

Denetim için UpdatePanel zaman uyumsuz geri göndermeyi tetikleyen denetimin adını alır veya ayarlar.

EventName

Güncelleştirilecek bir UpdatePanel denetimi tetikleyen geri gönderme denetimi olayını alır veya ayarlar.

Owner

Hedefin UpdatePanel denetimine UpdatePanelTrigger başvuru alır.

(Devralındığı yer: UpdatePanelTrigger)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindTargetControl(Boolean)

özelliğinde ControlID belirtilen denetimi arar.

(Devralındığı yer: UpdatePanelControlTrigger)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
HasTriggered()

Tetikleyicinin çağrılıp çağrılmadığını gösteren bir değer döndürür.

Initialize()

AsyncPostBackTrigger Denetimi başlatır ve tetikleyicide adlı olayın var olup olmadığını ve geçerli olup olmadığını belirler.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnEvent(Object, EventArgs)

Bir denetimin geri gönderilmesini ve yenilenmesini UpdatePanel tetikleyecek olayı tetikler.

ToString()

Geçerli AsyncPostBackTrigger denetimin dize gösterimini döndürür.

Şunlara uygulanır

Ayrıca bkz.