AsyncPostBackTrigger AsyncPostBackTrigger AsyncPostBackTrigger AsyncPostBackTrigger Class

Definition

Definiert ein Steuerelement und ein optionales Ereignis des Steuerelements als asynchronen Steuerelement-Postbacktrigger, der eine Aktualisierung des UpdatePanel-Steuerelements bewirkt.Defines a control and optional event of the control as an asynchronous postback control trigger that causes an UpdatePanel control to refresh.

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

Im folgenden Beispiel wird gezeigt, wie ein AsyncPostBackTrigger -Steuerelement deklarativ hinzugefügt wird.The following example shows how to add an AsyncPostBackTrigger control declaratively. Mithilfe Button eines Steuer Elements außerhalb eines UpdatePanel Steuer Elements können Benutzer einen Suchbegriff eingeben, um in Products der Tabelle der Northwind-Datenbank zu suchen.A Button control that is outside an UpdatePanel control lets users enter a search term to find in the Products table of the Northwind database. Ein GridView Steuerelement UpdatePanel im-Steuerelement zeigt die Ergebnisse an.A GridView control that is inside the UpdatePanel control shows the results. Das Button -Steuerelement wird als asynchroner-Wert für UpdatePanel das-Steuerelement angegeben.The Button control is specified as an asynchronous trigger for the UpdatePanel control.

<%@ 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 AsyncPostBackTrigger das-Steuerelement, um Steuerelemente für UpdatePanel ein-Steuerelement zu aktivieren.Use the AsyncPostBackTrigger control to enable controls to be triggers for an UpdatePanel control. Steuerelemente, bei denen es sich um Trigger für einen Aktualisierungs Bereich handelt, führen zu einer Aktualisierung des Bereichs Inhalts nach einem asynchronen Postback.Controls that are triggers for an update panel cause a refresh of the panel's content after an asynchronous postback. Die Definition eines asynchronen auslösersteuerelements ist in den folgenden Szenarien hilfreich:Defining an asynchronous trigger control is useful in the following scenarios:

  • Für Steuerelemente, die sich außerhalb eines Panels befinden.For controls that are outside a panel.

  • Für Steuerelemente, die sich innerhalb eines Panels ChildrenAsTriggers befinden, falsewenn die-Eigenschaft ist.For controls that are inside a panel when the ChildrenAsTriggers property is false.

  • Für Steuerelemente, die sich in geschachtelten Bereichen befinden, um das Aktualisieren von übergeordneten Panels zu bewirken.For controls that are inside nested panels, in order to cause a refresh of parent panels.

Das Steuerelement, AsyncPostBackTrigger auf das sich das Steuerelement bezieht, muss sich im gleichen Namens Container wie der Aktualisierungs Bereich befindenThe control that the AsyncPostBackTrigger control references must be in the same naming container as the update panel for which it is a trigger. Trigger, die auf Steuerelementen in anderen Benennungs Containern basieren, werden nicht unterstützt.Triggers that are based on controls in other naming containers are not supported.

Fügen AsyncPostBackTrigger Sie Steuerelemente entweder mithilfe des Dialog Felds Update Panel-Auflistungs- Editor im-Designer hinzu, Triggers oder indem Sie ein- UpdatePanel Element deklarativ im-Steuerelement erstellen.Add AsyncPostBackTrigger controls either by using the UpdatePanelTrigger Collection Editor dialog box in the designer or by creating a Triggers element declaratively in the UpdatePanel control. Die ControlID -Eigenschaft ist erforderlich, aber EventName die-Eigenschaft ist optional.The ControlID property is required, but the EventName property is optional. Wenn die EventName -Eigenschaft nicht angegeben wird DefaultEventAttribute , wird das-Attribut des-Steuer Elements verwendet, um das Standard Ereignis zu bestimmen.If the EventName property is not specified, the DefaultEventAttribute attribute of the control is used to determine the default event. Beispielsweise Button Click ist das-Ereignis das Standard Ereignis für das-Steuerelement.For example, the default event for the Button control is the Click event. Bei EventName der Eigenschaft wird die Groß-/Kleinschreibung nicht beachtetThe EventName property is case-insensitive.

Sie können auch auf einen Benennungs Container als einen-Auslösers verweisen.You can also reference a naming container as a trigger. In diesem Fall werden alle untergeordneten Steuerelemente im Container, die ein Postback bewirken, als Trigger UpdatePanel für das Steuerelement angesehen.In that case, all child controls in the container that cause a postback are considered triggers for the UpdatePanel control.

Programmgesteuerte hinzu AsyncPostBackTrigger fügen von Steuerelementen wird nicht unterstützt.Programmatically adding AsyncPostBackTrigger controls is not supported. Verwenden Sie zum programmgesteuerten Registrieren eines Postback-Steuer RegisterAsyncPostBackControl Elements die- ScriptManager Methode des-Steuer Elements.To programmatically register a postback control, use the RegisterAsyncPostBackControl method of the ScriptManager control. Anschließend wird die Update -Methode UpdatePanel des-Steuer Elements aufgerufen, wenn das Steuerelement zurückgibt.Then call the Update method of the UpdatePanel control when the control posts back.

Wenn Sie ein Steuerelement sowohl PostBackTrigger mit als auch AsyncPostBackTriggermit definieren, wird eine-Ausnahme ausgelöst.If you define a control using both PostBackTrigger and AsyncPostBackTrigger, an exception is thrown.

Konstruktoren

AsyncPostBackTrigger() AsyncPostBackTrigger() AsyncPostBackTrigger() AsyncPostBackTrigger()

Initialisiert eine neue Instanz einer AsyncPostBackTrigger-Klasse.Initializes a new instance of an AsyncPostBackTrigger class.

Eigenschaften

ControlID ControlID ControlID ControlID

Ruft den Namen des Steuerelements ab, das ein asynchrones Postback für ein UpdatePanel-Steuerelement auslöst, oder legt ihn fest.Gets or sets the name of the control that triggers an asynchronous postback for an UpdatePanel control.

EventName EventName EventName EventName

Ruft das Steuerelement-Postbackereignis ab, das die Aktualisierung eines UpdatePanel-Steuerelements auslöst, oder legt dieses fest.Gets or sets the postback control event that triggers an UpdatePanel control to be updated.

Owner Owner Owner Owner

Ruft einen Verweis auf das UpdatePanel-Steuerelement ab, das das Ziel des UpdatePanelTrigger darstellt.Gets a reference to the UpdatePanel control that the UpdatePanelTrigger targets.

(Inherited from UpdatePanelTrigger)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindTargetControl(Boolean) FindTargetControl(Boolean) FindTargetControl(Boolean) FindTargetControl(Boolean)

Sucht nach dem in der ControlID-Eigenschaft angegebenen Steuerelement.Searches for the control specified in the ControlID property.

(Inherited from UpdatePanelControlTrigger)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HasTriggered() HasTriggered() HasTriggered() HasTriggered()

Gibt einen Wert zurück, der angibt, ob der Trigger aufgerufen wurde.Returns a value that indicates whether the trigger was invoked.

Initialize() Initialize() Initialize() Initialize()

Initialisiert das AsyncPostBackTrigger-Steuerelement und bestimmt, ob das im Trigger benannte Ereignis vorhanden und gültig ist.Initializes the AsyncPostBackTrigger control and determines whether the event that is named in the trigger exists and is valid.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnEvent(Object, EventArgs) OnEvent(Object, EventArgs) OnEvent(Object, EventArgs) OnEvent(Object, EventArgs)

Löst das Ereignis aus, das ein Postback und eine Aktualisierung eines UpdatePanel-Steuerelements auslöst.Raises the event that will trigger a postback and refresh of an UpdatePanel control.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgendarstellung des aktuellen AsyncPostBackTrigger-Steuerelements zurück.Returns a string representation of the current AsyncPostBackTrigger control.

Gilt für:

Siehe auch