AsyncPostBackTrigger Klass

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Definierar en kontroll och valfri händelse av kontrollen som en asynkron postback-kontrollutlösare som gör att en UpdatePanel kontroll uppdateras.

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
Arv
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

Exempel

I följande exempel visas hur du lägger till en AsyncPostBackTrigger kontroll deklarativt. En Button kontroll som ligger utanför en UpdatePanel kontroll gör att användarna kan ange en sökterm för att hitta i tabellen i Products Northwind-databasen. En GridView kontroll som finns i UpdatePanel kontrollen visar resultatet. Kontrollen Button anges som en asynkron utlösare för UpdatePanel kontrollen.

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

Kommentarer

Använd kontrollen AsyncPostBackTrigger för att aktivera kontroller som utlöses för en UpdatePanel kontroll. Kontroller som utlöses för en uppdateringspanel orsakar en uppdatering av panelens innehåll efter en asynkron postback. Det är användbart att definiera en asynkron utlösarkontroll i följande scenarier:

  • För kontroller som finns utanför en panel.

  • För kontroller som finns i en panel när egenskapen ChildrenAsTriggers är false.

  • För kontroller som finns i kapslade paneler, för att orsaka en uppdatering av överordnade paneler.

Kontrollen som kontrollreferenserna AsyncPostBackTrigger refererar till måste finnas i samma namngivningscontainer som uppdateringspanelen som det är en utlösare för. Utlösare som baseras på kontroller i andra namngivningscontainrar stöds inte.

Lägg till AsyncPostBackTrigger kontroller antingen med hjälp av dialogrutan UpdatePanelTrigger Collection Editor i designern eller genom att skapa ett Triggers element deklarativt i UpdatePanel kontrollen. Egenskapen ControlID krävs, men egenskapen EventName är valfri. Om egenskapen EventName inte har angetts DefaultEventAttribute används kontrollens attribut för att fastställa standardhändelsen. Till exempel är Button standardhändelsen Click för kontrollen händelsen. Egenskapen EventName är skiftlägeskänslig.

Du kan också referera till en namngivningscontainer som en utlösare. I så fall betraktas alla underordnade kontroller i containern som orsakar en efteråterställning som utlösare för UpdatePanel kontrollen.

Programmatiskt tillägg av AsyncPostBackTrigger kontroller stöds inte. Om du vill registrera en postback-kontroll programmatiskt använder du RegisterAsyncPostBackControl kontrollens ScriptManager metod. Anropa Update sedan kontrollens UpdatePanel metod när kontrollen skickas tillbaka.

Om du definierar en kontroll med både PostBackTrigger och AsyncPostBackTriggergenereras ett undantag.

Konstruktorer

Name Description
AsyncPostBackTrigger()

Initierar en ny instans av en AsyncPostBackTrigger klass.

Egenskaper

Name Description
ControlID

Hämtar eller anger namnet på kontrollen som utlöser en asynkron postback för en UpdatePanel kontroll.
EventName

Hämtar eller anger den postback-kontrollhändelse som utlöser en UpdatePanel kontroll som ska uppdateras.
Owner

Hämtar en referens till den UpdatePanel kontroll som mål.UpdatePanelTrigger

(Ärvd från UpdatePanelTrigger)

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
FindTargetControl(Boolean)

Söker efter den kontroll som anges i egenskapen ControlID .

(Ärvd från UpdatePanelControlTrigger)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
HasTriggered()

Returnerar ett värde som anger om utlösaren anropades.
Initialize()

Initierar AsyncPostBackTrigger kontrollen och avgör om händelsen som namnges i utlösaren finns och är giltig.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnEvent(Object, EventArgs)

Genererar den händelse som utlöser en postback och uppdatering av en UpdatePanel kontroll.
ToString()

Returnerar en strängrepresentation av den aktuella AsyncPostBackTrigger kontrollen.

Gäller för

Se även