AsyncPostBackTrigger AsyncPostBackTrigger AsyncPostBackTrigger AsyncPostBackTrigger Class

Definición

Define un control y el evento opcional del control como desencadenador del control de postback asincrónico que provoca la actualización de un control UpdatePanel.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
Herencia

Ejemplos

El ejemplo siguiente muestra cómo agregar un AsyncPostBackTrigger controlar de forma declarativa.The following example shows how to add an AsyncPostBackTrigger control declaratively. Un Button control que está fuera de un UpdatePanel control permite a los usuarios escribir un término de búsqueda para buscar en el Products tabla de la base de datos Northwind.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. Un GridView control que está dentro del UpdatePanel control muestra los resultados.A GridView control that is inside the UpdatePanel control shows the results. El Button control se especifica como un desencadenador asincrónico para el UpdatePanel control.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>

Comentarios

Use la AsyncPostBackTrigger control para habilitar los controles que los desencadenadores para una UpdatePanel control.Use the AsyncPostBackTrigger control to enable controls to be triggers for an UpdatePanel control. Los controles que son los desencadenadores de un panel de actualización hace que se actualice el contenido del panel después de un postback asincrónico.Controls that are triggers for an update panel cause a refresh of the panel's content after an asynchronous postback. Definir un control de desencadenador asincrónico es útil en los escenarios siguientes:Defining an asynchronous trigger control is useful in the following scenarios:

  • Para los controles que están fuera de un panel.For controls that are outside a panel.

  • Para los controles que están dentro de un panel cuando el ChildrenAsTriggers propiedad es false.For controls that are inside a panel when the ChildrenAsTriggers property is false.

  • Para los controles que están dentro de paneles anidados, para provocar una actualización de los paneles primarios.For controls that are inside nested panels, in order to cause a refresh of parent panels.

El control que el AsyncPostBackTrigger referencias de control deben estar en el mismo contenedor de nomenclatura que el panel de actualización para que TI es un desencadenador.The control that the AsyncPostBackTrigger control references must be in the same naming container as the update panel for which it is a trigger. No se admiten los desencadenadores que se basan en los controles en otros contenedores de nomenclatura.Triggers that are based on controls in other naming containers are not supported.

Agregar AsyncPostBackTrigger controla mediante el UpdatePanelTrigger Editor de la colección cuadro de diálogo en el diseñador o mediante la creación de un Triggers elemento forma declarativa en el UpdatePanel control.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. El ControlID propiedad es obligatoria, pero la EventName propiedad es opcional.The ControlID property is required, but the EventName property is optional. Si el EventName propiedad no se especifica, el DefaultEventAttribute atributo del control se usa para determinar el evento predeterminado.If the EventName property is not specified, the DefaultEventAttribute attribute of the control is used to determine the default event. Por ejemplo, el evento predeterminado para el Button control es el Click eventos.For example, the default event for the Button control is the Click event. El EventName propiedad distingue mayúsculas de minúsculas.The EventName property is case-insensitive.

También puede hacer referencia a un contenedor de nomenclatura como desencadenador.You can also reference a naming container as a trigger. En ese caso, todos los controles secundarios en el contenedor que provocan una devolución de datos se consideran los desencadenadores para el UpdatePanel control.In that case, all child controls in the container that cause a postback are considered triggers for the UpdatePanel control.

Agregar mediante programación AsyncPostBackTrigger controles no se admite.Programmatically adding AsyncPostBackTrigger controls is not supported. Para registrar mediante programación un control de devolución de datos, use el RegisterAsyncPostBackControl método de la ScriptManager control.To programmatically register a postback control, use the RegisterAsyncPostBackControl method of the ScriptManager control. A continuación, llame a la Update método de la UpdatePanel controlar cuando el control realiza la devolución.Then call the Update method of the UpdatePanel control when the control posts back.

Si define un control mediante ambos PostBackTrigger y AsyncPostBackTrigger, se produce una excepción.If you define a control using both PostBackTrigger and AsyncPostBackTrigger, an exception is thrown.

Constructores

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

Inicializa una nueva instancia de una clase AsyncPostBackTrigger.Initializes a new instance of an AsyncPostBackTrigger class.

Propiedades

ControlID ControlID ControlID ControlID

Obtiene o establece el nombre del control que desencadena un postback asincrónico en un control UpdatePanel.Gets or sets the name of the control that triggers an asynchronous postback for an UpdatePanel control.

EventName EventName EventName EventName

Obtiene o establece el evento de postback que desencadena la actualización de un control UpdatePanel.Gets or sets the postback control event that triggers an UpdatePanel control to be updated.

Owner Owner Owner Owner

Obtiene una referencia al control UpdatePanel que tiene como destino UpdatePanelTrigger.Gets a reference to the UpdatePanel control that the UpdatePanelTrigger targets.

(Inherited from UpdatePanelTrigger)

Métodos

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Busca el control especificado en la propiedad ControlID.Searches for the control specified in the ControlID property.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Devuelve un valor que indica si se invocó el desencadenador.Returns a value that indicates whether the trigger was invoked.

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

Inicializa el control AsyncPostBackTrigger y determina si el evento citado en el desencadenador existe y es válido.Initializes the AsyncPostBackTrigger control and determines whether the event that is named in the trigger exists and is valid.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Genera el evento que desencadenará un postback y una actualización de un control UpdatePanel.Raises the event that will trigger a postback and refresh of an UpdatePanel control.

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

Devuelve una representación de cadena del control AsyncPostBackTrigger actual.Returns a string representation of the current AsyncPostBackTrigger control.

Se aplica a

Consulte también: