Inicio Library Aprendizaje Code Descarga Soporte Comunidad Foros
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

UpdatePanel (Clase)

.NET Framework 4.5

Habilita secciones de una página para que se presenten parcialmente sin postback.

Espacio de nombres:  System.Web.UI
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)
C#
C++
F#
VB
Copiar 
public class UpdatePanel : Control, 
	IAttributeAccessor
ASP.NET
Copiar 
<asp:UpdatePanel />

El tipo UpdatePanel expone los siguientes miembros.

  NombreDescripción
Método públicoUpdatePanelInicializa una nueva instancia de la clase UpdatePanel.
Arriba
  NombreDescripción
Propiedad protegidaAdapterobtiene el adaptador explorador-específico para el control. (Se hereda de Control).
Propiedad públicaAppRelativeTemplateSourceDirectoryObtiene o establece el directorio virtual aplicación-relativo del objeto de Page o de UserControl que contiene este control. (Se hereda de Control).
Propiedad públicaAttributesObtiene la colección de atributos de hoja de estilos en cascada (CSS) del control UpdatePanel.
Propiedad públicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad protegidaChildControlsCreatedObtiene un valor que indica si se han creado los controles secundarios del control de servidor. (Se hereda de Control).
Propiedad públicaChildrenAsTriggersObtiene o establece un valor que indica si los postbacks de los controles secundarios inmediatos de un control UpdatePanel actualizan el contenido del panel.
Propiedad públicaClientIDObtiene el identificador del control para el formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad públicaClientIDModeobtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad de ClientID . (Se hereda de Control).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separador usado en la propiedad de ClientID . (Se hereda de Control).
Propiedad públicaContentTemplateObtiene o establece la plantilla que define el contenido del control UpdatePanel.
Propiedad públicaContentTemplateContainerObtiene un objeto de control al que puede agregar controles secundarios mediante programación.
Propiedad protegidaContextObtiene el objeto de HttpContext asociado al control de servidor para la solicitud web actual. (Se hereda de Control).
Propiedad públicaControlsObtiene el objeto ControlCollection que contiene los controles secundarios del control UpdatePanel. (Invalida a Control.Controls).
Propiedad públicaDataItemContainerObtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Se hereda de Control).
Propiedad públicaDataKeysContainerObtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Se hereda de Control).
Propiedad protegidaDesignModeObtiene un valor que indica si un control se utiliza en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEnableThemingObtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de Control).
Propiedad públicaEnableViewStateObtiene o establece un valor que indica si el control de servidor el estado de vista, y el estado de vista de los controles secundarios que contiene, el cliente que efectúa la solicitud. (Se hereda de Control).
Propiedad protegidaEventsObtiene una lista de los delegados de controladores de eventos del control. Esta propiedad es de solo lectura. (Se hereda de Control).
Propiedad protegidaHasChildViewStateObtiene un valor que indica si los controles secundarios del control actuales de servidor tengan los valores guardados del estado de vista. (Se hereda de Control).
Propiedad públicaIDObtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegidaIdSeparatorInfraestructura. obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad protegidaIsChildControlStateClearedObtiene un valor que indica si los controles contenidos dentro de este control tienen el estado del control. (Se hereda de Control).
Propiedad públicaIsInPartialRenderingObtiene un valor que indica si se actualiza el control UpdatePanel a consecuencia de un postback asincrónico.
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el control de servidor es guardar cambios en el estado de vista. (Se hereda de Control).
Propiedad protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad protegidaLoadViewStateByIDObtiene un valor que indica si el control participa en la carga el estado de vista en ID en lugar de índice. (Se hereda de Control).
Propiedad públicaNamingContainerObtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para distinguir entre los controles de servidor con el mismo valor de propiedad de Control.ID . (Se hereda de Control).
Propiedad públicaPageobtiene una referencia a la instancia de Page que contiene el control de servidor. (Se hereda de Control).
Propiedad públicaParentObtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad públicaRenderingCompatibilityObtiene un valor que especifica la versión de ASP.NET con la que generó HTML será compatible. (Se hereda de Control).
Propiedad públicaRenderModeObtiene o establece un valor que indica si el contenido de un control UpdatePanel se incluye en un <div> HTML o en un elemento de <span>.
Propiedad protegidaRequiresUpdateObtiene un valor que indica si se va a actualizar el contenido del control UpdatePanel.
Propiedad públicaSiteObtiene información sobre el contenedor que hospeda el control actual cuando se genera en una superficie de diseño. (Se hereda de Control).
Propiedad públicaSkinIDObtiene o establece la máscara para aplicar al control. (Se hereda de Control).
Propiedad públicaTemplateControlobtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad públicaTemplateSourceDirectoryobtiene el directorio virtual de Page o de UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad públicaTriggersObtiene un objeto UpdatePanelTriggerCollection que contiene los objetos AsyncPostBackTrigger y PostBackTrigger que se registraron mediante declaración para el control UpdatePanel.
Propiedad públicaUniqueIDObtiene el identificador único, jerárquico completo para el control de servidor. (Se hereda de Control).
Propiedad públicaUpdateModeObtiene o establece un valor que indica cuándo se actualiza un control de contenido UpdatePanel.
Propiedad públicaValidateRequestModeObtiene o establece un valor que indica si el control comprueba entrada del explorador por valores potencialmente peligrosos. (Se hereda de Control).
Propiedad protegidaViewStateObtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página. (Se hereda de Control).
Propiedad protegidaViewStateIgnoresCaseObtiene un valor que indica si el objeto de StateBag no distingue entre mayúsculas y minúsculas. (Se hereda de Control).
Propiedad públicaViewStateModeObtiene o establece el modo de estado de vista de este control. (Se hereda de Control).
Propiedad públicaVisibleObtiene o establece un valor que indica si un control de servidor se genera como una interfaz de usuario en la página. (Se hereda de Control).
Arriba
  NombreDescripción
Método protegidoAddedControlSe llama después de un control secundario se agrega a la colección de Controls del objeto de Control . (Se hereda de Control).
Método protegidoAddParsedSubObjectNotifica al control de servidor que un elemento, XML o HTML, se ha analizado, y agrega el elemento al objeto de ControlCollection de control de servidor. (Se hereda de Control).
Método públicoApplyStyleSheetSkinSe aplican las propiedades de estilo definidas en la hoja de estilos de la página al control. (Se hereda de Control).
Método protegidoBeginRenderTracingSeguimiento de tiempo de diseño comienza de los datos de representación. (Se hereda de Control).
Método protegidoBuildProfileTreeInfraestructura. Recopila información sobre el control de servidor y la entrega a la propiedad de Trace se muestre cuando la traza está habilitada para la página. (Se hereda de Control).
Método protegidoClearCachedClientIDInfraestructura. establece el valor almacenado en caché de ClientID a null. (Se hereda de Control).
Método protegidoClearChildControlStateElimina la información del estado de control para los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildStateElimina la información de estado y del estado de control para los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildViewStateElimina la información de estado para los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearEffectiveClientIDModeInfraestructura. Establece la propiedad de ClientIDMode de la instancia actual del control y de los controles secundarios a Inherit. (Se hereda de Control).
Método protegidoCreateChildControlsLlamado por el marco de trabajo de páginas ASP.NET para notificar los controles de servidor que implementación composición-basada uso para crear los controles secundarios que contienen con objeto de reserva u objeto de asociar. (Se hereda de Control).
Método protegidoCreateContentTemplateContainerCrea un objeto Control que actúa como contenedor de los controles secundarios que definen el contenido del control UpdatePanel.
Método protegidoCreateControlCollectionDevuelve la colección de todos los controles contenidos en el control UpdatePanel. (Invalida a Control.CreateControlCollection()).
Método públicoDataBind()Enlaza un origen de datos al control de servidor invocado y todos sus controles secundarios. (Se hereda de Control).
Método protegidoDataBind(Boolean)Enlaza un origen de datos al control de servidor invocado y todos sus controles secundarios con una opción de generar el evento de DataBinding . (Se hereda de Control).
Método protegidoDataBindChildrenEnlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método públicoDisposePermite a un control de servidor para realizar final limpian antes de que se libere de memoria. (Se hereda de Control).
Método protegidoEndRenderTracingSeguimiento de tiempo de los extremos de los datos de representación. (Se hereda de Control).
Método protegidoEnsureChildControlsDetermina si el control de servidor contiene controles secundarios. si no hace, crea los controles secundarios. (Se hereda de Control).
Método protegidoEnsureIDcrea un identificador para los controles que no tienen un identificador asignado. (Se hereda de Control).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindControl(String)Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro especificado de id . (Se hereda de Control).
Método protegidoFindControl(String, Int32)Infraestructura. Busca el contenedor de nomenclatura actual para un control de servidor con id especificado y un entero, especificado en el parámetro de pathOffset , que ayuda en la búsqueda. No debe invalidar esta versión del método de FindControl . (Se hereda de Control).
Método públicoFocusEstablece el foco en un control. (Se hereda de Control).
Método protegidoGetDesignModeStateInfraestructura. Obtiene los datos de tiempo de diseño para un control. (Se hereda de Control).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetRouteUrl(Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de la ruta. (Se hereda de Control).
Método públicoGetRouteUrl(RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de la ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoGetUniqueIDRelativeToDevuelve la parte fija de la propiedad de UniqueID de control especificado. (Se hereda de Control).
Método públicoHasControlsDetermina si el control de servidor contiene los controles secundarios. (Se hereda de Control).
Método protegidoHasEventsDevuelve un valor que indica si los eventos están registrados para el control o los controles secundarios. (Se hereda de Control).
Método protegidoInitializeInicializa la colección de desencadenadores del control UpdatePanel si se habilita la representación de página parcial.
Método protegidoIsLiteralContentInfraestructura. Determina si el control de servidor contiene sólo el contenido literal. (Se hereda de Control).
Método protegidoLoadControlStateRestaura la información del estado de control de una solicitud de página anterior que se guardada por el método de SaveControlState . (Se hereda de Control).
Método protegidoLoadViewStateRestaura la información de estado de una solicitud de página anterior que se guardada por el método de SaveViewState . (Se hereda de Control).
Método protegidoMapPathSecureRecupera la ruta de acceso física a la que una ruta de acceso virtual, absoluto o relativos, mapas. (Se hereda de Control).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnBubbleEventDetermina si el evento para el control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario de la página. (Se hereda de Control).
Método protegidoOnDataBindingProvoca el evento de DataBinding . (Se hereda de Control).
Método protegidoOnInitGenera el evento Init. (Invalida a Control.OnInit(EventArgs)).
Método protegidoOnLoadGenera el evento Load del control UpdatePanel e invoca el método Initialize cuando no se habilita la representación de página parcial. (Invalida a Control.OnLoad(EventArgs)).
Método protegidoOnPreRenderGenera el evento PreRender. (Invalida a Control.OnPreRender(EventArgs)).
Método protegidoOnUnloadGenera el evento Unload base. (Invalida a Control.OnUnload(EventArgs)).
Método protegidoOpenFileobtiene Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegidoRaiseBubbleEventAsigna cualquier origen de eventos y de la información al elemento primario del control. (Se hereda de Control).
Método protegidoRemovedControlSe llama después de un control secundario se quita de la colección de Controls del objeto de Control . (Se hereda de Control).
Método protegidoRenderGenera el evento Render. (Invalida a Control.Render(HtmlTextWriter)).
Método protegidoRenderChildrenGenera el evento RenderChildren. (Invalida a Control.RenderChildren(HtmlTextWriter)).
Método públicoRenderControl(HtmlTextWriter)El contenido del control de servidor outputs a un objeto proporcionado de HtmlTextWriter y almacena la información de traza sobre el control si está habilitado el seguimiento. (Se hereda de Control).
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Contenido del control de servidor outputs a un objeto proporcionado de HtmlTextWriter utilizando el objeto proporcionado de ControlAdapter . (Se hereda de Control).
Método protegidoResolveAdapterObtiene el adaptador de control responsable de generar el control especificado. (Se hereda de Control).
Método públicoResolveClientUrlObtiene una dirección URL que pueda ser utilizada en el explorador. (Se hereda de Control).
Método públicoResolveUrlConvierte una dirección URL en una que sea utilizable en el cliente que realiza la solicitud. (Se hereda de Control).
Método protegidoSaveControlStateGuarda cualquier cambio de estado de control de servidor que ha producido desde el tiempo que la página se envía al servidor. (Se hereda de Control).
Método protegidoSaveViewStateGuarda cualquier cambio de estado de vista del control de servidor que ha producido desde el tiempo que la página se envía al servidor. (Se hereda de Control).
Método protegidoSetDesignModeStateEstablece los datos de tiempo de diseño para un control. (Se hereda de Control).
Método públicoSetRenderMethodDelegateInfraestructura. Asigna a un delegado del controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control).
Método públicoSetTraceData(Object, Object)Los conjuntos siguen paso a paso los datos de seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoSetTraceData(Object, Object, Object)Los conjuntos siguen paso a paso los datos de seguimiento en tiempo de diseño de los datos de representación, utilizando el objeto seguido paso a paso, la clave de datos de seguimiento, y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoToStringDevuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateHace que el seguimiento de los cambios de estado del control de servidor para que se pueden almacenar en el objeto de StateBag de control de servidor. este objeto es accesible a través de la propiedad de Control.ViewState . (Se hereda de Control).
Método públicoUpdateGenera una actualización del contenido de un control UpdatePanel.
Arriba
  NombreDescripción
Evento públicoDataBindingSe produce cuando el control de servidor enlazado a un origen de datos. (Se hereda de Control).
Evento públicoDisposedSe produce cuando un control de servidor se libera de memoria, que es la fase del ciclo de vida del control de servidor en que se solicita una página ASP.NET. (Se hereda de Control).
Evento públicoInitSe produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida. (Se hereda de Control).
Evento públicoLoadSe produce cuando el control de servidor se carga en el objeto de Page . (Se hereda de Control).
Evento públicoPreRenderSe produce cuando el objeto de Control se carga pero antes de la presentación. (Se hereda de Control).
Evento públicoUnloadSe produce cuando el control de servidor se descargan de la memoria. (Se hereda de Control).
Arriba
  NombreDescripción
Método de extensión públicoFindDataSourceControlDevuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindFieldTemplateDevuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindMetaTableDevuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Arriba
  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.GetAttributeDevuelve un atributo de un control web utilizando el nombre especificado.
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.SetAttributeEstablece el valor del atributo del control especificado.
Implementación explícita de interfacesPropiedad privadaIControlBuilderAccessor.ControlBuilderPara obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.GetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetOwnerControlInfraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIControlDesignerAccessor.UserDataPara obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.DataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.HasDataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.ExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.HasExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIParserAccessor.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Arriba

En este tema:

Introduction

Los controles UpdatePanel son una parte fundamental de la funcionalidad AJAX en ASP.NET. Se usan con el control ScriptManager para habilitar la representación de una página parcial. Esta representación reduce la necesidad de postbacks sincrónicos y actualizaciones de página completa cuando solamente se debe actualizar parte de la página. La representación de página parcial mejora la experiencia del usuario porque reduce el parpadeo de la pantalla que se produce durante un postback de página completa y mejora la interactividad de páginas web.

Actualizar el contenido de UpdatePanel

Cuando se habilita la representación parcial de la página, un control puede realizar un postback que actualiza la página entera o un postback asincrónico que actualiza el contenido de uno o más controles UpdatePanel. Si un control genera un postback asincrónico y actualiza un control UpdatePanel depende de lo siguiente:

  • Si la propiedad UpdateMode del control UpdatePanel se establece en Always, el contenido del control UpdatePanel se actualiza en cada postback que se origine en la página. Se incluyen los postback asincrónicos de controles que están dentro de otros controles UpdatePanel y postbacks de controles que no están dentro de los controles UpdatePanel.

  • Si la propiedad UpdateMode se establece en Conditional, el contenido del control UpdatePanel se actualiza en los siguientes casos:

    • Al llamar explícitamente al método Update del control UpdatePanel.

    • Cuando se anida el control UpdatePanel dentro de otro control UpdatePanel y se actualiza el panel primario.

    • Cuando un control que se define como desencadenador mediante la propiedad Triggers del control UpdatePanel genera un postback. En este escenario, el control activa explícitamente una actualización del contenido del panel. El control puede ser interior o exterior respecto al control UpdatePanel al que se asocia el desencadenador.

    • Cuando la propiedad ChildrenAsTriggers se establece en true y un control secundario del control UpdatePanel provoca un postback. Los controles secundarios de los controles UpdatePanel anidados no provocan actualizaciones del control UpdatePanel externo a menos que se definan explícitamente como desencadenadores.

No se permite la combinación de establecer la propiedad ChildrenAsTriggers en false y la propiedad UpdateMode en Always y produce una excepción.

Cuando el control UpdatePanel realiza un envío asincrónico, agrega un encabezado HTTP personalizado. Algunos proxies quitan este encabezado HTTP personalizado. Si es así, el servidor controla la solicitud como un postback normal, lo que genera un error en el cliente. Para resolver este problema, inserte un campo de formulario personalizado cuando realice envíos asincrónicos. A continuación, compruebe el encabezado o el campo de formulario personalizado en el código de servidor.

Uso de UpdatePanel

Puede utilizar varios controles UpdatePanel para actualizar las diferentes regiones de una página independientemente. Cuando primero se representa la página que contiene uno o más controles UpdatePanel, se representa y se envía todo el contenido de todos los controles UpdatePanel al explorador. En los postbacks asincrónicos subsiguientes, el contenido de cada control UpdatePanel quizá no se pueda actualizar dependiendo de la configuración del panel y de la lógica de cliente o de servidor de los paneles individuales.

También puede utilizar los controles UpdatePanel en los escenarios siguientes:

  • En controles de usuario.

  • En las páginas maestras y de contenido.

  • Anidados en otros controles UpdatePanel.

  • Dentro de controles con plantilla como los controles GridView o Repeater.

Se pueden agregar los controles UpdatePanel mediante declaración o programación.

Puede agregar un control UpdatePanel mediante programación, pero no puede agregar desencadenadores de esta forma. Para crear comportamiento como desencadenador, puede registrar un control en la página como control de postback asincrónico. Para hacer esto llame al método RegisterAsyncPostBackControl del control ScriptManager. Después puede crear un controlador de eventos que se ejecute como respuesta al postback asincrónico y, en el controlador, llame al método Update del control UpdatePanel.

Aplicar estilos

El control UpdatePanel acepta atributos expando. Esto le permite establecer una clase CSS para los elementosHTML que los controles representan. Por ejemplo, podría crear el marcado que se muestra en el ejemplo siguiente:

Copiar 
<asp:UpdatePanel runat="server" class="myStyle">
</asp:UpdatePanel>

El marcado en el ejemplo anterior representa HTML similar al siguiente cuando la página se ejecuta:

Copiar 
<div id="ctl00_MainContent_UpdatePanel1" class="MyStyle">
</div>

Sintaxis de la declaración

Copiar 
<asp:UpdatePanel
    ChildrenAsTriggers="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    RenderMode="Block|Inline"
    runat="server"
    SkinID="string"
    UpdateMode="Always|Conditional"
    Visible="True|False"
>
    <ContentTemplate>
        <!-- child controls -->
    </ContentTemplate>
    <Triggers>
        <asp:AsyncPostBackTrigger 
            ControlID="string"
            EventName="string"
        />
        <asp:PostBackTrigger 
            ControlID="string"
        />
    </Triggers>
</asp:UpdatePanel>
TopicLocation
Información general sobre el control UpdatePanelGenerar aplicaciones Web ASP .NET en Visual Studio
Crear una página ASP.NET simple con varios controles UpdatePanelGenerar aplicaciones Web ASP .NET en Visual Studio
Introducción al control UpdateProgressGenerar aplicaciones Web ASP .NET en Visual Studio
Usar el control UpdatePanel de ASP.NET con controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Dar prioridad a una devolución de datos asincrónica específicaGenerar aplicaciones Web ASP .NET en Visual Studio
Usar el control UpdatePanel de ASP.NET con controles de usuarioGenerar aplicaciones Web ASP .NET en Visual Studio
Cancelar una devolución de datos asincrónicaGenerar aplicaciones Web ASP .NET en Visual Studio
Información general sobre el control UpdateProgressGenerar aplicaciones Web ASP .NET en Visual Studio
Información general sobre el control ScriptManagerGenerar aplicaciones Web ASP .NET en Visual Studio
Usar el control UpdatePanel de ASP.NET con páginas maestrasGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Animar controles UpdatePanel de ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Usar el control UpdatePanel con un servicio webGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Usar controles de validación en un control UpdatePanelGenerar aplicaciones Web ASP .NET en Visual Studio
Personalizar el control de errores para los controles UpdatePanel de ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Introducción al control UpdatePanelGenerar aplicaciones Web ASP .NET en Visual Studio

En los ejemplos siguientes, se muestran distintos usos del control UpdatePanel.

Controles dentro de un control UpdatePanel

En el ejemplo siguiente, se muestra la colocación de los controles dentro de un control UpdatePanel para reducir el parpadeo de la pantalla al exponer en el servidor. En este ejemplo, los controles Calendar y DropDownList están dentro de un control UpdatePanel. De forma predeterminada, el valor de la propiedad UpdateMode es Always y el de la propiedad ChildrenAsTriggers es true. Por consiguiente, los controles secundarios del panel provocan un postback asincrónico.

C#
VB
Copiar 


<%@ 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">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

Escenario de maestro/detalle con controles UpdatePanel

En el ejemplo siguiente, se usa un control UpdatePanel en un escenario de maestro/detalle que muestra los pedidos y los detalles de los pedidos de la base de datos Northwind. Un control UpdatePanel contiene el control GridView que muestra una lista de pedidos. Un segundo control UpdatePanel contiene un control DetailsView que muestra los detalles de un pedido. Al seleccionar un pedido de la primera tabla, los detalles para ese pedido se muestran en la segunda tabla. Esta tabla se actualiza de forma asincrónica basándose en la selección en la primera. Las operaciones de paginación y ordenación de la tabla de resumen de pedidos también provocan actualizaciones parciales.

C#
VB
Copiar 

<%@ 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 GridView1_SelectedIndexChanged(object sender, EventArgs e)
    {
        SqlDataSource2.SelectParameters["OrderID"].DefaultValue = 
            GridView1.SelectedDataKey.Value.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server" />
            <asp:UpdatePanel ID="OrdersPanel"
                             UpdateMode="Conditional"
                             runat="server">
                <ContentTemplate>
                    <asp:GridView ID="GridView1" 
                                  AllowPaging="True"
                                  AllowSorting="True"
                                  Caption="Orders"
                                  DataKeyNames="OrderID"
                                  DataSourceID="SqlDataSource1"
                                  OnSelectedIndexChanged="GridView1_SelectedIndexChanged"
                                  runat="server" >
                    <Columns>
                    <asp:CommandField ShowSelectButton="True"></asp:CommandField>
                    </Columns>
                    </asp:GridView>
                    <asp:SqlDataSource ID="SqlDataSource1"
                                       runat="server"
                                       ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                                       SelectCommand="SELECT [OrderID], [CustomerID], [EmployeeID], [OrderDate] FROM [Orders]">
                    </asp:SqlDataSource>
                </ContentTemplate>
            </asp:UpdatePanel>
            <asp:UpdatePanel ID="OrderDetailsPanel"
                             UpdateMode="Always"
                             runat="server">
                <ContentTemplate>
                    <asp:DetailsView ID="DetailsView1"
                                     Caption="Order Details"
                                     DataKeyNames="OrderID,ProductID"
                                     DataSourceID="SqlDataSource2"
                                     runat="server">
                        <EmptyDataTemplate>
                        <i>Select a row from the Orders table.</i>
                        </EmptyDataTemplate>
                    </asp:DetailsView>
                    <asp:SqlDataSource ID="SqlDataSource2"
                                       ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                                       SelectCommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity], [Discount] FROM [Order Details] WHERE ([OrderID] = @OrderID)"
                                       runat="server">
                        <SelectParameters>
                            <asp:Parameter Name="OrderID"
                                           Type="Int32" />
                        </SelectParameters>
                    </asp:SqlDataSource>
                </ContentTemplate>
            </asp:UpdatePanel>
        </div>
    </form>
</body>
</html>

Si coloca un control GridView dentro de un control UpdatePanel, no se admite el establecimiento del valor de la propiedad EnableSortingAndPagingCallbacks del control GridView en true. Sin embargo, puesto que el control UpdatePanel admite los postbacks asincrónicos, cualquier postback que cambie el control GridView dentro de un control UpdatePanel provocan el mismo comportamiento que las devoluciones de llamada de ordenación y paginación.

Usar un control UpdatePanel en una plantilla

En el ejemplo siguiente se usa un control UpdatePanel en la plantilla de elemento de un control GridView. Automáticamente se generan los controles UpdatePanel en cada fila de datos. El control UpdatePanel de cada fila contiene un control Label con el fin de mostrar la parte del elemento de esa fila y un control Button para reducir y aumentar esa parte.

C#
VB
Copiar 


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

    private void ChangeQuantity(object sender, int delta)
    {
        Label quantityLabel = (Label)((Button)sender).FindControl("QuantityLabel");
        int currentQuantity = Int32.Parse(quantityLabel.Text);
        currentQuantity = Math.Max(0, currentQuantity + delta);
        quantityLabel.Text = currentQuantity.ToString(System.Globalization.CultureInfo.InvariantCulture);
    }

    private void OnDecreaseQuantity(object sender, EventArgs e)
    {
        ChangeQuantity(sender, -1);
    }

    private void OnIncreaseQuantity(object sender, EventArgs e)
    {
        ChangeQuantity(sender, 1);
    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        StringBuilder sb = new StringBuilder();
        sb.Append("Beverage order:<br/>");
        foreach (GridViewRow row in GridView1.Rows)
        {
            if (row.RowType == DataControlRowType.DataRow)
            {
                Label quantityLabel = (Label)row.FindControl("QuantityLabel");
                int currentQuantity = Int32.Parse(quantityLabel.Text);
                sb.Append(row.Cells[0].Text + " : " + currentQuantity + "<br/>");
            }
        }
        SummaryLabel.Text = sb.ToString();

    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Inside GridView Template Example </title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:GridView ID="GridView1" 
                          AutoGenerateColumns="False"
                          DataSourceID="SqlDataSource1"
                          runat="server">
                <Columns>
                    <asp:BoundField DataField="ProductName" 
                                    HeaderText="ProductName" />
                    <asp:BoundField DataField="UnitPrice"
                                    HeaderText="UnitPrice" />
                    <asp:TemplateField HeaderText="Quantity">
                        <ItemTemplate>
                            <asp:UpdatePanel ID="QuantityUpdatePanel"
                                             UpdateMode="Conditional"
                                             runat="server" >
                                <ContentTemplate>
                                    <asp:Label ID="QuantityLabel"
                                               Text="0"
                                               runat="server" />
                                    <asp:Button ID="DecreaseQuantity"
                                                Text="-"
                                                OnClick="OnDecreaseQuantity"
                                                runat="server" />
                                    <asp:Button ID="IncreaseQuantity" 
                                                Text="+"
                                                OnClick="OnIncreaseQuantity"
                                                runat="server" />
                                </ContentTemplate>
                            </asp:UpdatePanel>
                        </ItemTemplate>
                    </asp:TemplateField>
                </Columns>
            </asp:GridView>            
            <asp:UpdatePanel ID="SummaryUpdatePanel" 
                             UpdateMode="Conditional"
                             runat="server">
                <ContentTemplate>
                    <asp:Button ID="Button1"
                                OnClick="Button1_Click"
                                Text="Get Summary"
                                runat="server" />
                    <br />
                    <asp:Label ID="SummaryLabel"
                               runat="server">
                    </asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <asp:SqlDataSource ID="SqlDataSource1"
                               ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
                               SelectCommand="SELECT [ProductName], [UnitPrice] FROM 
                               [Alphabetical list of products] WHERE ([CategoryName] 
                               LIKE '%' + @CategoryName + '%')"
                               runat="server">
                <SelectParameters>
                    <asp:Parameter DefaultValue="Beverages"
                                   Name="CategoryName"
                                   Type="String" />
                </SelectParameters>
            </asp:SqlDataSource>
        </div>
    </form>
</body>
</html>

.NET Framework

Compatible con: 4.5, 4, 3.5

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Te ha resultado útil?
(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR
© 2013 Microsoft. Reservados todos los derechos.