Freigeben über

AsyncPostBackTrigger Klasse

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Definiert ein Steuerelement und ein optionales Ereignis des Steuerelements als asynchroner Postbacksteuerelementtrigger, der dazu führt, dass ein UpdatePanel Steuerelement aktualisiert wird.

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
Object
UpdatePanelTrigger
UpdatePanelControlTrigger
AsyncPostBackTrigger

Beispiele

Das folgende Beispiel zeigt, wie ein AsyncPostBackTrigger Steuerelement deklarativ hinzugefügt wird. Mit einem Button Steuerelement außerhalb eines UpdatePanel Steuerelements können Benutzer einen Suchbegriff eingeben, der in der Products Tabelle der Northwind-Datenbank zu finden ist. 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 für ein UpdatePanel Steuerelement auszulösen. Steuerelemente, die für einen Updatebereich ausgelöst werden, führen nach einem asynchronen Postback zu einer Aktualisierung des Inhalts des Panels. Das Definieren eines asynchronen Triggersteuerelements ist in den folgenden Szenarien hilfreich:

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

  • Bei Steuerelementen, die sich innerhalb eines Bereichs befinden, wenn die ChildrenAsTriggers Eigenschaft ist false.

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

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

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

Sie können auch als Trigger auf einen Benennungscontainer verweisen. In diesem Fall werden alle untergeordneten Steuerelemente im Container, die zu einem Postback führen, 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 Postbacksteuerelement programmgesteuert zu registrieren. Rufen Sie dann die Update Methode des UpdatePanel Steuerelements auf, wenn das Steuerelement wieder bereitgestellt wird.

Wenn Sie ein Steuerelement mit beiden PostBackTrigger und AsyncPostBackTriggereiner Ausnahme definieren, wird eine Ausnahme ausgelöst.

Konstruktoren

Name Beschreibung
AsyncPostBackTrigger()

Initialisiert eine neue Instanz einer AsyncPostBackTrigger Klasse.

Eigenschaften

Name Beschreibung
ControlID

Dient zum Abrufen oder Festlegen des Namens des Steuerelements, das einen asynchronen Postback für ein UpdatePanel Steuerelement auslöst.
EventName

Ruft das Postback-Steuerelementereignis ab, das ein UpdatePanel Steuerelement auslöst, das aktualisiert wird, oder legt dieses fest.
Owner

Ruft einen Verweis auf das UpdatePanel Steuerelement ab, das die UpdatePanelTrigger Ziele hat.

(Geerbt von UpdatePanelTrigger)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FindTargetControl(Boolean)

Sucht nach dem steuerelement, das in der ControlID Eigenschaft angegeben ist.

(Geerbt von UpdatePanelControlTrigger)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die 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 der aktuellen Object.

(Geerbt von Object)
OnEvent(Object, EventArgs)

Löst das Ereignis aus, das einen Postback und eine Aktualisierung eines UpdatePanel Steuerelements auslöst.
ToString()

Gibt eine Zeichenfolgendarstellung des aktuellen AsyncPostBackTrigger Steuerelements zurück.

Gilt für:

Weitere Informationen