Partager via

AsyncPostBackTrigger Classe

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Définit un contrôle et un événement facultatif du contrôle en tant que déclencheur de contrôle de publication asynchrone qui provoque l’actualisation d’un UpdatePanel contrôle.

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

Exemples

L’exemple suivant montre comment ajouter un AsyncPostBackTrigger contrôle de manière déclarative. Un Button contrôle qui se trouve en dehors d’un UpdatePanel contrôle permet aux utilisateurs d’entrer un terme de recherche à rechercher dans la Products table de la base de données Northwind. Un GridView contrôle qui se trouve à l’intérieur du UpdatePanel contrôle affiche les résultats. Le Button contrôle est spécifié en tant que déclencheur asynchrone pour le UpdatePanel contrôle.

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

Remarques

Utilisez le AsyncPostBackTrigger contrôle pour permettre aux contrôles d’être des déclencheurs pour un UpdatePanel contrôle. Les contrôles qui sont des déclencheurs pour un panneau de mise à jour provoquent une actualisation du contenu du panneau après une publication asynchrone. La définition d’un contrôle de déclencheur asynchrone est utile dans les scénarios suivants :

  • Pour les contrôles qui se trouvent en dehors d’un panneau.

  • Pour les contrôles qui se trouvent à l’intérieur d’un panneau lorsque la ChildrenAsTriggers propriété est false.

  • Pour les contrôles qui se trouvent à l’intérieur de panneaux imbriqués, afin de provoquer une actualisation des panneaux parents.

Le contrôle que les références de AsyncPostBackTrigger contrôle doivent se trouver dans le même conteneur d’affectation de noms que le panneau de mise à jour pour lequel il s’agit d’un déclencheur. Les déclencheurs basés sur des contrôles dans d’autres conteneurs d’affectation de noms ne sont pas pris en charge.

Ajoutez AsyncPostBackTrigger des contrôles à l’aide de la boîte de dialogue Éditeur de collection UpdatePanelTrigger dans le concepteur ou en créant un Triggers élément de manière déclarative dans le UpdatePanel contrôle. La ControlID propriété est requise, mais la EventName propriété est facultative. Si la EventName propriété n’est pas spécifiée, l’attribut DefaultEventAttribute du contrôle est utilisé pour déterminer l’événement par défaut. Par exemple, l’événement par défaut pour le Button contrôle est l’événement Click . La propriété ne respecte pas la EventName casse.

Vous pouvez également référencer un conteneur d’affectation de noms en tant que déclencheur. Dans ce cas, tous les contrôles enfants du conteneur qui provoquent une publication sont considérés comme des déclencheurs pour le UpdatePanel contrôle.

L’ajout AsyncPostBackTrigger de contrôles par programmation n’est pas pris en charge. Pour inscrire par programmation un contrôle de publication, utilisez la RegisterAsyncPostBackControl méthode du ScriptManager contrôle. Ensuite, appelez la Update méthode du UpdatePanel contrôle lorsque le contrôle publie de nouveau.

Si vous définissez un contrôle à l’aide des deux PostBackTrigger et AsyncPostBackTriggerqu’une exception est levée.

Constructeurs

Nom Description
AsyncPostBackTrigger()

Initialise une nouvelle instance d’une AsyncPostBackTrigger classe.

Propriétés

Nom Description
ControlID

Obtient ou définit le nom du contrôle qui déclenche une publication asynchrone pour un UpdatePanel contrôle.
EventName

Obtient ou définit l’événement de contrôle de publication qui déclenche la mise à jour d’un UpdatePanel contrôle.
Owner

Obtient une référence au UpdatePanel contrôle que les UpdatePanelTrigger cibles.

(Hérité de UpdatePanelTrigger)

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FindTargetControl(Boolean)

Recherche le contrôle spécifié dans la ControlID propriété.

(Hérité de UpdatePanelControlTrigger)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
HasTriggered()

Retourne une valeur qui indique si le déclencheur a été appelé.
Initialize()

Initialise le AsyncPostBackTrigger contrôle et détermine si l’événement nommé dans le déclencheur existe et est valide.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnEvent(Object, EventArgs)

Déclenche l’événement qui déclenche une publication et une actualisation d’un UpdatePanel contrôle.
ToString()

Retourne une représentation sous forme de chaîne du contrôle actuel AsyncPostBackTrigger .

S’applique à

Voir aussi