Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase AsyncPostBackTrigger

 

Publicado: octubre de 2016

Define un control y el evento opcional del control como un desencadenador de control de devolución de datos asincrónica que provoca un UpdatePanel actualización de control.

Espacio de nombres:   System.Web.UI
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)


public class AsyncPostBackTrigger : UpdatePanelControlTrigger

NombreDescripción
System_CAPS_pubmethodAsyncPostBackTrigger()

Inicializa una nueva instancia de un AsyncPostBackTrigger clase.

NombreDescripción
System_CAPS_pubpropertyControlID

Obtiene o establece el nombre del control que desencadena una devolución asincrónica para una UpdatePanel control.

System_CAPS_pubpropertyEventName

Obtiene o establece el evento de devolución de datos de control que desencadena un UpdatePanel actualización del control.

System_CAPS_pubpropertyOwner

Obtiene una referencia a la UpdatePanel que controlan la UpdatePanelTrigger destinos.(Heredado de UpdatePanelTrigger).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_protmethodFindTargetControl(Boolean)

Busca el control especificado en el ControlID propiedad.(Heredado de UpdatePanelControlTrigger).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodHasTriggered()

Devuelve un valor que indica si se invocó el desencadenador.(Invalida UpdatePanelTrigger.HasTriggered()).

System_CAPS_protmethodInitialize()

Inicializa el AsyncPostBackTrigger control y determina si el evento que se menciona en el desencadenador existe y es válido.(Invalida UpdatePanelTrigger.Initialize()).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodOnEvent(Object, EventArgs)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Provoca el evento que desencadenará una devolución de datos y la actualización de un UpdatePanel control.

System_CAPS_pubmethodToString()

Devuelve una representación de cadena del actual AsyncPostBackTrigger control.(Invalida Object.ToString()).

Utilice el AsyncPostBackTrigger control para habilitar los controles puedan ser los desencadenadores para una UpdatePanel control. Controles que son los desencadenadores de un panel de actualización provocan una actualización del contenido del panel después de un postback asincrónico. Definir un control de desencadenador asincrónico es útil en los escenarios siguientes:

  • Para los controles que están fuera de un panel.

  • Para los controles que están dentro de un panel cuando el ChildrenAsTriggers propiedad es false.

  • Para los controles que están dentro de paneles anidados, para provocar una actualización de los paneles primarios.

El control que el AsyncPostBackTrigger referencias de control deben estar en el mismo contenedor de nomenclatura que el panel de actualización para el cual es un desencadenador. No se admiten los desencadenadores que se basan en los controles en otros contenedores de nomenclatura.

Agregar AsyncPostBackTrigger controla mediante el UpdatePanelTrigger Editor de la colección cuadro de diálogo en el diseñador o creando un Triggers elemento de forma declarativa en el UpdatePanel control. El ControlID propiedad es necesaria, pero la EventName propiedad es opcional. Si el EventName no se especifica la propiedad, el DefaultEventAttribute atributo del control se utiliza para determinar el evento predeterminado. Por ejemplo, el evento predeterminado para el Button control es el Click eventos. El EventName propiedad distingue mayúsculas de minúsculas.

También puede hacer referencia a un contenedor de nomenclatura como desencadenador. En ese caso, todos los controles secundarios en el contenedor que provocan una devolución de datos se consideran desencadenadores para el UpdatePanel control.

Agregar mediante programación AsyncPostBackTrigger controles no se admite. Para registrar mediante programación un control de devolución de datos, use la RegisterAsyncPostBackControl método de la ScriptManager control. A continuación, llame el Update método de la UpdatePanel control cuando el control realiza la devolución.

Si define un control mediante PostBackTrigger y AsyncPostBackTrigger, se produce una excepción.

En el ejemplo siguiente se muestra cómo agregar un AsyncPostBackTrigger control de forma declarativa. 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 la tabla de la base de datos Northwind. Un GridView control que está dentro del UpdatePanel control muestra los resultados. El Button control se especifica como desencadenador asincrónico para el 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>

.NET Framework
Disponible desde 3.5

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: