AsyncPostBackTrigger Klas

Definitie

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

Definieert een besturingselement en een optionele gebeurtenis van het besturingselement als een asynchrone terugdraaitrigger die ervoor zorgt dat een UpdatePanel besturingselement wordt vernieuwd.

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

Voorbeelden

In het volgende voorbeeld ziet u hoe u een AsyncPostBackTrigger besturingselement declaratief toevoegt. Met Button een besturingselement dat zich buiten een UpdatePanel besturingselement bevindt, kunnen gebruikers een zoekterm invoeren in de Products tabel van de Northwind-database. Een GridView besturingselement in het UpdatePanel besturingselement toont de resultaten. Het Button besturingselement wordt opgegeven als een asynchrone trigger voor het UpdatePanel besturingselement.

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

Opmerkingen

Gebruik het AsyncPostBackTrigger besturingselement om besturingselementen in te schakelen voor triggers voor een UpdatePanel besturingselement. Besturingselementen die worden geactiveerd voor een updatepaneel veroorzaken een vernieuwing van de inhoud van het deelvenster na een asynchrone postback. Het definiëren van een asynchroon triggerbesturingselement is handig in de volgende scenario's:

  • Voor besturingselementen die zich buiten een deelvenster bevinden.

  • Voor besturingselementen die zich in een deelvenster bevinden wanneer de ChildrenAsTriggers eigenschap zich bevindt false.

  • Voor besturingselementen die zich in geneste panelen bevinden, om een vernieuwing van bovenliggende panelen te veroorzaken.

Het besturingselement waarnaar de AsyncPostBackTrigger besturingselementen verwijzen, moet zich in dezelfde naamgevingscontainer bevinden als het updatepaneel waarvoor het een trigger is. Triggers die zijn gebaseerd op besturingselementen in andere naamgevingscontainers, worden niet ondersteund.

Besturingselementen toevoegen AsyncPostBackTrigger met behulp van het dialoogvenster UpdatePanelTrigger Collection Editor in de ontwerpfunctie of door een Triggers element declaratief in het UpdatePanel besturingselement te maken. De ControlID eigenschap is vereist, maar de EventName eigenschap is optioneel. Als de EventName eigenschap niet is opgegeven, wordt het DefaultEventAttribute kenmerk van het besturingselement gebruikt om de standaard gebeurtenis te bepalen. De standaard gebeurtenis voor het Button besturingselement is bijvoorbeeld de Click gebeurtenis. De EventName eigenschap is niet hoofdlettergevoelig.

U kunt ook verwijzen naar een naamgevingscontainer als trigger. In dat geval worden alle onderliggende besturingselementen in de container die een postback veroorzaken beschouwd als triggers voor het UpdatePanel besturingselement.

Programmatisch besturingselementen toevoegen AsyncPostBackTrigger wordt niet ondersteund. Als u een postback-besturingselement programmatisch wilt registreren, gebruikt u de RegisterAsyncPostBackControl methode van het ScriptManager besturingselement. Roep vervolgens de Update methode van het UpdatePanel besturingselement aan wanneer het besturingselement wordt teruggezet.

Als u een besturingselement definieert met beide PostBackTrigger en AsyncPostBackTrigger, wordt er een uitzondering gegenereerd.

Constructors

Name Description
AsyncPostBackTrigger()

Initialiseert een nieuw exemplaar van een AsyncPostBackTrigger klasse.

Eigenschappen

Name Description
ControlID

Hiermee haalt u de naam op van het besturingselement dat een asynchrone postback activeert voor een UpdatePanel besturingselement.
EventName

Hiermee haalt u de gebeurtenis voor het terugdraaien van besturingselementen op waarmee een UpdatePanel besturingselement wordt geactiveerd dat moet worden bijgewerkt.
Owner

Hiermee wordt een verwijzing naar het UpdatePanel besturingselement opgehaald dat de UpdatePanelTrigger doelen hebben.

(Overgenomen van UpdatePanelTrigger)

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
FindTargetControl(Boolean)

Hiermee wordt gezocht naar het besturingselement dat is opgegeven in de ControlID eigenschap.

(Overgenomen van UpdatePanelControlTrigger)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
HasTriggered()

Retourneert een waarde die aangeeft of de trigger is aangeroepen.
Initialize()

Initialiseert het AsyncPostBackTrigger besturingselement en bepaalt of de gebeurtenis die in de trigger wordt genoemd, bestaat en geldig is.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnEvent(Object, EventArgs)

Hiermee wordt de gebeurtenis gegenereerd die een terugdraaiactie activeert en een UpdatePanel besturingselement vernieuwt.
ToString()

Retourneert een tekenreeksweergave van het huidige AsyncPostBackTrigger besturingselement.

Van toepassing op

Zie ook