Freigeben über


AsyncPostBackTrigger Klasse

Definition

Definiert ein Steuerelement und ein optionales Ereignis des Steuerelements als asynchronen Steuerelement-Postbacktrigger, der eine Aktualisierung des UpdatePanel-Steuerelements bewirkt.

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
Vererbung

Beispiele

Das folgende Beispiel zeigt, wie Sie ein AsyncPostBackTrigger Steuerelement deklarativ hinzufügen. Mit Button einem Steuerelement, das sich außerhalb eines Steuerelements UpdatePanel befindet, können Benutzer einen Suchbegriff eingeben, der in der Products Tabelle der Northwind-Datenbank gesucht werden soll. Ein GridView Steuerelement, das sich innerhalb des UpdatePanel Steuerelements befindet, zeigt die Ergebnisse an. Das Button Steuerelement wird als asynchroner Trigger für das UpdatePanel Steuerelement angegeben.

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

Hinweise

Verwenden Sie das AsyncPostBackTrigger -Steuerelement, um Steuerelemente als Trigger für ein UpdatePanel Steuerelement zu aktivieren. Steuerelemente, die Trigger für einen Updatebereich sind, führen nach einem asynchronen Postback zu einer Aktualisierung des Bereichsinhalts. Das Definieren eines asynchronen Triggersteuerelements ist in den folgenden Szenarien nützlich:

  • Für Steuerelemente, die sich außerhalb eines Bereichs befinden.

  • Für Steuerelemente, die sich in einem Bereich befinden, wenn die ChildrenAsTriggers -Eigenschaft ist false.

  • Für Steuerelemente, die sich in geschachtelten Bereichen befinden, um eine Aktualisierung der übergeordneten Bereiche zu bewirken.

Das Steuerelement, auf das das AsyncPostBackTrigger Steuerelement verweist, muss sich im gleichen Namenscontainer wie der Updatebereich befinden, für den es ein Trigger ist. Trigger, die auf Steuerelementen in anderen Namenscontainern basieren, werden nicht unterstützt.

Fügen Sie AsyncPostBackTrigger Steuerelemente entweder mithilfe des Dialogfelds UpdatePanelTrigger-Sammlungs-Editor im Designer oder durch deklaratives Erstellen eines Triggers Elements im UpdatePanel Steuerelement hinzu. Die ControlID -Eigenschaft ist erforderlich, aber die EventName -Eigenschaft ist optional. Wenn die EventName -Eigenschaft nicht angegeben ist, wird das DefaultEventAttribute -Attribut des Steuerelements verwendet, um das Standardereignis zu bestimmen. Das Standardereignis für das Button Steuerelement ist z. B. das Click -Ereignis. Bei der EventName Eigenschaft wird die Groß-/Kleinschreibung nicht beachtet.

Sie können auch als Trigger auf einen Namenscontainer verweisen. In diesem Fall werden alle untergeordneten Steuerelemente im Container, die ein Postback verursachen, als Trigger für das UpdatePanel Steuerelement betrachtet.

Das programmgesteuerte Hinzufügen von AsyncPostBackTrigger Steuerelementen wird nicht unterstützt. Verwenden Sie die RegisterAsyncPostBackControl -Methode des ScriptManager -Steuerelements, um ein Postback-Steuerelement programmgesteuert zu registrieren. Rufen Sie dann die Update -Methode des UpdatePanel Steuerelements auf, wenn das Steuerelement zurücksent.

Wenn Sie ein Steuerelement mit und PostBackTriggerAsyncPostBackTriggerdefinieren, wird eine Ausnahme ausgelöst.

Konstruktoren

AsyncPostBackTrigger()

Initialisiert eine neue Instanz einer AsyncPostBackTrigger-Klasse.

Eigenschaften

ControlID

Ruft den Namen des Steuerelements ab, das ein asynchrones Postback für ein UpdatePanel-Steuerelement auslöst, oder legt ihn fest.

EventName

Ruft das Steuerelement-Postbackereignis ab, das die Aktualisierung eines UpdatePanel-Steuerelements auslöst, oder legt dieses fest.

Owner

Ruft einen Verweis auf das UpdatePanel-Steuerelement ab, das das Ziel des UpdatePanelTrigger darstellt.

(Geerbt von UpdatePanelTrigger)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindTargetControl(Boolean)

Sucht nach dem in der ControlID-Eigenschaft angegebenen Steuerelement.

(Geerbt von UpdatePanelControlTrigger)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HasTriggered()

Gibt einen Wert zurück, der angibt, ob der Trigger aufgerufen wurde.

Initialize()

Initialisiert das AsyncPostBackTrigger-Steuerelement und bestimmt, ob das im Trigger benannte Ereignis vorhanden und gültig ist.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnEvent(Object, EventArgs)

Löst das Ereignis aus, das ein Postback und eine Aktualisierung eines UpdatePanel-Steuerelements auslöst.

ToString()

Gibt eine Zeichenfolgendarstellung des aktuellen AsyncPostBackTrigger-Steuerelements zurück.

Gilt für:

Weitere Informationen