Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

AsyncPostBackTrigger classe

 

Date de publication : novembre 2016

Définit un contrôle et un événement facultatif de contrôle comme déclencheur de contrôle de publication (postback) asynchrone qui provoque un UpdatePanel contrôle à actualiser.

Espace de noms:   System.Web.UI
Assembly:  System.Web.Extensions (dans System.Web.Extensions.dll)


public class AsyncPostBackTrigger : UpdatePanelControlTrigger

NomDescription
System_CAPS_pubmethodAsyncPostBackTrigger()

Initialise une nouvelle instance d’un AsyncPostBackTrigger (classe).

NomDescription
System_CAPS_pubpropertyControlID

Obtient ou définit le nom du contrôle qui déclenche une publication (postback) asynchrone pour une UpdatePanel contrôle.

System_CAPS_pubpropertyEventName

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

System_CAPS_pubpropertyOwner

Obtient une référence à la UpdatePanel qui contrôle le UpdatePanelTrigger cibles.(Hérité de UpdatePanelTrigger.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_protmethodFindTargetControl(Boolean)

Recherche le contrôle spécifié dans le ControlID propriété.(Hérité de UpdatePanelControlTrigger.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodHasTriggered()

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

System_CAPS_protmethodInitialize()

Initialise le AsyncPostBackTrigger contrôler et détermine si l’événement qui est nommé dans le déclencheur existe et est valide.(Remplace UpdatePanelTrigger.Initialize().)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodOnEvent(Object, EventArgs)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Déclenche l’événement qui déclenchera une publication (postback) et l’actualisation d’un UpdatePanel contrôle.

System_CAPS_pubmethodToString()

Retourne une représentation de chaîne de l’utilisateur actuel AsyncPostBackTrigger contrôle.(Remplace Object.ToString().)

Utilisez la 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 entraînent une actualisation du contenu du panneau après une publication asynchrone. Définition d’un contrôle de déclencheur asynchrone est utile dans les scénarios suivants :

  • Pour les contrôles situés en dehors d’un panneau de configuration.

  • Pour les contrôles situés à l’intérieur d’un panneau lorsque le ChildrenAsTriggers propriété est false.

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

Le contrôle qui le AsyncPostBackTrigger références de contrôle doivent être dans le même conteneur d’attribution de noms que le panneau de mise à jour pour lesquels il est un déclencheur. Les déclencheurs qui sont basés sur les contrôles dans d’autres conteneurs d’attribution de noms ne sont pas pris en charge.

Ajouter AsyncPostBackTrigger contrôle à l’aide de la éditeur de collections UpdatePanelTrigger boîte de dialogue dans le concepteur ou en créant un Triggers élément de façon déclarative dans la UpdatePanel contrôle. Le ControlID propriété est requise, mais le EventName propriété est facultative. Si le EventName propriété n’est pas spécifiée, le DefaultEventAttribute attribut 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 le Click événement. Le EventName propriété respecte la casse.

Vous pouvez également référencer un conteneur d’attribution de noms comme un déclencheur. Dans ce cas, tous les contrôles enfants dans le conteneur qui provoquent une publication sont considérées comme déclencheurs pour le UpdatePanel contrôle.

Ajouter par programmation AsyncPostBackTrigger contrôles n’est pas pris en charge. Pour enregistrer par programme un contrôle de publication, utilisez la RegisterAsyncPostBackControl Procédé de la ScriptManager contrôle. Puis appelez le Update Procédé de la UpdatePanel contrôle lorsque le contrôle est publié.

Si vous définissez un contrôle à la fois PostBackTrigger et AsyncPostBackTrigger, une exception est levée.

L’exemple suivant montre comment ajouter un AsyncPostBackTrigger contrôler de manière déclarative. A Button contrôle qui est à l’extérieur une UpdatePanel contrôle permet aux utilisateurs d’entrer un terme de recherche pour rechercher dans le Products table de la base de données Northwind. Un GridView contrôle qui se trouve dans le 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>

.NET Framework
Disponible depuis 3.5

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: