AsyncPostBackTrigger Třída

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 PostBackTrigger AsyncPostBackTrigger, 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é

PostBackTrigger