Sdílet prostřednictvím

AsyncPostBackTrigger Třída

  • Reference

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í postback řízení trigger, 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ý se nachází mimo ovládací UpdatePanel prvek, umožňuje uživatelům zadat hledaný termín, Products který najdou v tabulce databáze Northwind. Ovládací GridView prvek, který je uvnitř ovládacího prvku, UpdatePanel zobrazuje výsledky. Ovládací Button prvek je určen jako asynchronní aktivační událost pro UpdatePanel ovládací prvek.

<%@ 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í ovládacích prvků jako aktivačních událostí ovládacího UpdatePanel prvku. Ovládací prvky, které jsou triggery pro aktualizační panel, způsobí aktualizaci obsahu panelu po asynchronním zpětném odeslání. Definování ovládacího prvku asynchronní aktivační události 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 .

  • Pro ovládací prvky, které jsou uvnitř vnořených panelů, aby se způsobila aktualizace nadřazených panelů.

Ovládací prvek, na který ovládací prvek odkazuje, AsyncPostBackTrigger musí být ve stejném kontejneru názvů jako panel aktualizací, pro který je triggerem. Triggery, které jsou založené na ovládacích prvcích v jiných názvových kontejnerech, se nepodporují.

Přidejte AsyncPostBackTrigger ovládací prvky pomocí dialogového okna UpdatePanelTrigger Collection Editor v návrháři nebo vytvořením elementu Triggers deklarativně v ovládacím UpdatePanel prvku. Vlastnost ControlID je povinná, ale EventName je volitelná. EventName Pokud vlastnost není zadána, DefaultEventAttribute atribut ovládacího prvku se použije k určení výchozí události. Výchozí událostí Button ovládacího prvku je Click například událost . U vlastnosti se EventName nerozlišují malá a velká písmena.

Jako trigger můžete také odkazovat na názvový kontejner. V takovém případě jsou všechny podřízené ovládací prvky v kontejneru, které způsobují zpětné odeslání, považovány za UpdatePanel triggery ovládacího prvku.

Přidávání ovládacích prvků prostřednictvím kódu AsyncPostBackTrigger programu není podporováno. Pokud chcete ovládací prvek zpětného odeslání zaregistrovat prostřednictvím kódu programu, použijte RegisterAsyncPostBackControl metodu ScriptManager ovládacího prvku . Potom zavolejte metodu Update ovládacího prvku, UpdatePanel když se ovládací prvek vrátí zpět.

Pokud definujete ovládací prvek pomocí i PostBackTriggerAsyncPostBackTrigger, vyvolá se výjimka.

Konstruktory

AsyncPostBackTrigger()

Inicializuje novou instanci AsyncPostBackTrigger třídy.

Vlastnosti

ControlID

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

Získá nebo nastaví postback řízení událost, která aktivuje ovládací prvek UpdatePanel k aktualizaci.
Owner

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

(Zděděno od UpdatePanelTrigger)

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná 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í hashovací funkce.

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

Type Získá z aktuální instance.

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

Vrátí hodnotu, která označuje, jestli byl trigger vyvolán.
Initialize()

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

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

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

Vyvolá událost, která aktivuje zpětné odeslání a aktualizaci ovládacího prvku UpdatePanel .
ToString()

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

Platí pro

Viz také