Aracılığıyla paylaş

AsyncPostBackTrigger Sınıf

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.Extensions.dll

Denetimin bir denetimini ve isteğe bağlı olayını, denetimin yenilenmesine neden olan zaman uyumsuz geri gönderme denetimi tetikleyicisi UpdatePanel 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
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

Ö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 bir 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 denetimin tetikleyicisi olmasını sağlamak için denetimi kullanın. Güncelleştirme panelinin tetikleyicileri olan denetimler, zaman uyumsuz geri gönderme işleminden sonra 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 olduğunda panelin ChildrenAsTriggers içindeki denetimler falseiçin.

  • üst panellerin yenilenmesine neden olmak için iç içe yerleştirilmiş panellerin içindeki denetimler 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 bildirimli olarak UpdatePanel bir Triggers öğe oluşturarak denetimleri ekleyinAsyncPostBackTrigger. ControlID özelliği gereklidir, ancak EventName özelliği isteğe bağlıdır. EventName Özelliği belirtilmezse, DefaultEventAttribute varsayılan olayı belirlemek için denetimin özniteliği kullanılır. Örneğin, denetimin varsayılan olayı Button olaydır Click . EventName özelliği büyük/küçük harfe duyarlı değildir.

Ayrıca 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

Name Description
AsyncPostBackTrigger()

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

Özellikler

Name Description
ControlID

Bir denetim için UpdatePanel zaman uyumsuz bir geri gönderme 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

Hedeflediğini UpdatePanelUpdatePanelTrigger denetime bir başvuru alır.

(Devralındığı yer: UpdatePanelTrigger)

Yöntemler

Name Description
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()

Geçerli örneğin Type 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 Objectbasit 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.