WebPartManager.WebPartsDisconnecting Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce durante el proceso de finalización de la conexión entre los controles de servidor o conectados WebPart previamente.
public:
event System::Web::UI::WebControls::WebParts::WebPartConnectionsCancelEventHandler ^ WebPartsDisconnecting;public event System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler WebPartsDisconnecting;member this.WebPartsDisconnecting : System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler Public Custom Event WebPartsDisconnecting As WebPartConnectionsCancelEventHandler Tipo de evento
Comentarios
El WebPartsDisconnecting evento se genera mediante el OnWebPartsDisconnecting método y indica el hecho de que un usuario ha hecho clic en un verbo desconectado o se ha llamado al DisconnectWebParts método de otro modo. El evento ofrece la oportunidad de cancelar el proceso de finalización de una conexión antes de que se complete. Si la conexión finaliza correctamente, este evento va seguido del WebPartsDisconnected evento .
Los desarrolladores de páginas pueden agregar un controlador personalizado para el evento agregando el OnWebPartsDisconnecting atributo al <asp:webpartmanager> elemento y asignando un nombre de método personalizado al atributo .
Normalmente, cuando el WebPartsDisconnecting evento se genera como resultado directo de la acción de un usuario que finaliza una conexión, se puede cancelar el evento. Sin embargo, hay varios escenarios en los que no se puede cancelar el evento. El primer escenario es, si se elimina un WebPartZone control, los WebPart controles que contiene deben cerrarse; de lo contrario, estarían huérfanos. En este caso, el WebPartManager control cierra los WebPart controles, no el usuario, y también debe poder finalizar las conexiones de cualquier control conectado sin posibilidad de interrupción, de modo que pueda completar el proceso de limpieza y cierre todos los controles. Por lo tanto, por diseño el WebPartsDisconnecting método no se puede cancelar en este escenario. Para ver un evento relacionado que se puede cancelar, consulte el WebPartClosing evento .
El segundo escenario en el que no se puede cancelar el WebPartsDisconnecting evento es cuando se llama al ActivateConnections método (esto se llama durante cada solicitud a una página, por ejemplo), y hay algún tipo de conflicto en las conexiones existentes en una página. Por ejemplo, quizás un usuario conecta el control x para controlar y, pero un usuario compartido conecta el control x al control z y, sin embargo, el control x no puede formar varias conexiones. En este caso, la configuración del usuario individual para la conexión tiene prioridad y el WebPartManager control resuelve el conflicto llamando al DisconnectWebPart método y finalizando la conexión entre x y z para el usuario en particular. Dado que esta desconexión es esencial para resolver el conflicto, el WebPartsDisconnecting evento no se puede cancelar en este escenario.
El tercer escenario en el que el WebPartsDisconnecting método no se puede cancelar es cuando se elimina o cierra un WebPart control de servidor o que está conectado actualmente. Dado que definitivamente el control se va a quitar de la página, es una necesidad lógica de quitar su conexión. Por lo tanto, cuando el WebPartManager control invoca el DisconnectWebPart método , que a su vez genera el WebPartsDisconnecting evento, por diseño no existe la posibilidad de cancelar el evento.
