Sdílet prostřednictvím

AsyncPostBackTrigger Třída

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.Extensions.dll

Definuje ovládací prvek a volitelnou událost ovládacího prvku jako asynchronní aktivační událost ovládacího prvku postback, který způsobí UpdatePanel aktualizaci ovládacího prvku.

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
Dědičnost
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

Příklady

Následující příklad ukazuje, jak přidat AsyncPostBackTrigger ovládací prvek deklarativní. Ovládací Button prvek, který je mimo UpdatePanel ovládací prvek, umožňuje uživatelům zadat hledaný termín, který najde v Products tabulce databáze Northwind. Výsledek GridView zobrazí ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku. Ovládací Button prvek je určen jako asynchronní aktivační událost UpdatePanel ovládacího prvku.

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

Poznámky

AsyncPostBackTrigger Ovládací prvek slouží k povolení aktivačních událostí ovládacích UpdatePanel prvků pro ovládací prvek. Ovládací prvky, které se aktivují pro aktualizační panel, způsobují aktualizaci obsahu panelu po asynchronním zpětném odeslání. Definování asynchronního ovládacího prvku triggeru je užitečné v následujících scénářích:

  • Pro ovládací prvky, které jsou mimo panel.

  • Pro ovládací prvky, které jsou uvnitř panelu ChildrenAsTriggers , když je falsevlastnost .

  • U ovládacích prvků, které jsou uvnitř vnořených panelů, může dojít k aktualizaci nadřazených panelů.

Ovládací prvek, který AsyncPostBackTrigger odkazuje na ovládací prvek, musí být ve stejném kontejneru pojmenování jako aktualizační panel, pro který se jedná o trigger. Triggery založené na ovládacích prvcích v jiných kontejnerech pojmenování se nepodporují.

Přidejte AsyncPostBackTrigger ovládací prvky buď pomocí UpdatePanelTrigger Collection Editor dialogové okno v návrháři nebo vytvořením Triggers elementu deklarativní v ovládacím UpdatePanel prvku. Vlastnost ControlID je povinná, ale EventName tato vlastnost je volitelná. EventName Pokud vlastnost není zadána, DefaultEventAttribute atribut ovládacího prvku slouží k určení výchozí události. Například výchozí událost Button ovládacího prvku je Click událost. Vlastnost EventName nerozlišuje velká a malá písmena.

Jako trigger můžete také odkazovat na kontejner pojmenování. V takovém případě se všechny podřízené ovládací prvky v kontejneru, které způsobují postback, považují za triggery pro UpdatePanel ovládací prvek.

Přidávání AsyncPostBackTrigger ovládacích prvků prostřednictvím kódu programu se nepodporuje. Pokud chcete programově zaregistrovat ovládací prvek postback, použijte RegisterAsyncPostBackControl metodu ScriptManager ovládacího prvku. Potom zavolejte Update metodu UpdatePanel ovládacího prvku, když ovládací prvek publikuje zpět.

Pokud definujete ovládací prvek pomocí obou PostBackTrigger a AsyncPostBackTrigger, je vyvolán výjimka.

Konstruktory

Name Description
AsyncPostBackTrigger()

Inicializuje novou instanci AsyncPostBackTrigger třídy.

Vlastnosti

Name Description
ControlID

Získá nebo nastaví název ovládacího prvku, který aktivuje asynchronní postback pro UpdatePanel ovládací prvek.
EventName

Získá nebo nastaví postback řídicí událost, která aktivuje UpdatePanel ovládací prvek, který má být aktualizován.
Owner

Získá odkaz na UpdatePanel ovládací prvek, který cílí UpdatePanelTrigger .

(Zděděno od UpdatePanelTrigger)

Metody

Name Description
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
FindTargetControl(Boolean)

Vyhledá ovládací prvek zadaný ve ControlID vlastnosti.

(Zděděno od UpdatePanelControlTrigger)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
HasTriggered()

Vrátí hodnotu, která označuje, jestli byla aktivační událost vyvolána.
Initialize()

Inicializuje AsyncPostBackTrigger ovládací prvek a určuje, zda událost pojmenovaná v triggeru existuje a je platná.
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
OnEvent(Object, EventArgs)

Vyvolá událost, která aktivuje postback a aktualizaci UpdatePanel ovládacího prvku.
ToString()

Vrátí řetězcovou reprezentaci aktuálního AsyncPostBackTrigger ovládacího prvku.

Platí pro

Viz také