AsyncPostBackTrigger Osztály

Definíció

Névtér:: System.Web.UI

Szerelvény:: System.Web.Extensions.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A vezérlő vezérlőjének és opcionális eseményének meghatározása aszinkron utólagos vezérlési eseményindítóként, amely egy UpdatePanel vezérlő frissítését okozza.

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

Öröklődés: Object

UpdatePanelTrigger

UpdatePanelControlTrigger
AsyncPostBackTrigger

Példák

Az alábbi példa bemutatja, hogyan adhat hozzá vezérlőelemet AsyncPostBackTrigger deklaratív módon. Egy Button vezérlőn kívüli UpdatePanel vezérlőelem lehetővé teszi, hogy a felhasználók keresési kifejezést adjanak meg a Products Northwind-adatbázis táblájában. A GridView vezérlőn belüli UpdatePanel vezérlőelem megjeleníti az eredményeket. A Button vezérlő aszinkron eseményindítóként van megadva.UpdatePanel

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

Megjegyzések

A vezérlő használatával engedélyezheti, hogy a AsyncPostBackTrigger vezérlők eseményindítók legyenek egy UpdatePanel vezérlőhöz. A frissítési panel eseményindítóinak vezérlői aszinkron visszavétel után frissítik a panel tartalmát. Az aszinkron eseményindító vezérlőelem definiálása a következő esetekben hasznos:

Panelen kívüli vezérlők esetén.
Panelen belüli vezérlők esetén, ha a tulajdonság értéke ChildrenAsTriggers .false
Beágyazott paneleken belüli vezérlők esetén, amelyek a szülőpanelek frissítését okozzák.

Annak a vezérlőnek, amelyre a AsyncPostBackTrigger vezérlőhivatkozások hivatkoznak, ugyanabban az elnevezési tárolóban kell lennie, mint annak a frissítési panelnek, amelynek eseményindítója. A más elnevezési tárolók vezérlőin alapuló eseményindítók nem támogatottak.

Vezérlők hozzáadásához AsyncPostBackTrigger használja az UpdatePanelTrigger Gyűjteményszerkesztő párbeszédpanelt a tervezőben, vagy hozzon létre egy Triggers elemet deklaratív módon a UpdatePanel vezérlőben. A ControlID tulajdonság megadása kötelező, de a EventName tulajdonság nem kötelező. Ha a EventName tulajdonság nincs megadva, a DefaultEventAttribute vezérlő attribútuma határozza meg az alapértelmezett eseményt. A vezérlő alapértelmezett eseménye például az Button Click esemény. A EventName tulajdonság nem érzékeny a kis- és nagybetűkre.

Az elnevezési tárolókra eseményindítóként is hivatkozhat. Ebben az esetben a visszavételt okozó tároló összes gyermekvezérlője UpdatePanel a vezérlő eseményindítóinak minősül.

A vezérlők programozott hozzáadása AsyncPostBackTrigger nem támogatott. Ha programozott módon szeretne regisztrálni egy utólagos vezérlőt, használja a RegisterAsyncPostBackControl ScriptManager vezérlő metódusát. Ezután hívja meg a Update vezérlő metódusát UpdatePanel , amikor a vezérlő visszatér.

Ha a vezérlőelemet mindkettővel PostBackTrigger definiálja, a AsyncPostBackTriggerrendszer kivételt jelez.

Konstruktorok

Name	Description
AsyncPostBackTrigger()	Inicializál egy osztály új példányát AsyncPostBackTrigger .

Tulajdonságok

Name	Description
ControlID	Lekéri vagy beállítja annak a vezérlőnek a nevét, amely aszinkron utómunkát indít el egy UpdatePanel vezérlőhöz.
EventName	Lekéri vagy beállítja a visszaállítás utáni vezérlő eseményét, amely elindítja a UpdatePanel vezérlő frissítését.
Owner	A cél vezérlőelemre UpdatePanel UpdatePanelTrigger mutató hivatkozást kap. (Öröklődés forrása UpdatePanelTrigger)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FindTargetControl(Boolean)	Megkeresi a tulajdonságban megadott vezérlőt ControlID . (Öröklődés forrása UpdatePanelControlTrigger)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
HasTriggered()	Olyan értéket ad vissza, amely jelzi, hogy az eseményindítót meghívták-e.
Initialize()	Inicializálja a AsyncPostBackTrigger vezérlőt, és meghatározza, hogy az eseményindítóban megnevezett esemény létezik-e és érvényes-e.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnEvent(Object, EventArgs)	Elindítja azt az eseményt, amely egy vezérlő utólagos és frissítési műveletét UpdatePanel indítja el.
ToString()	Az aktuális AsyncPostBackTrigger vezérlő sztring-ábrázolását adja vissza.

A következőre érvényes:

Lásd még

PostBackTrigger

Visszajelzés

Hasznosnak találta ezt az oldalt?