WebPartManager.WebPartsDisconnecting Evento

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Se produce durante el proceso de finalizar la conexión entre controles WebPart o controles de servidor previamente conectados.

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

WebPartConnectionsCancelEventHandler

Comentarios

El WebPartsDisconnecting método genera el OnWebPartsDisconnecting evento y señala el hecho de que un usuario ha hecho clic en un verbo de desconexión o se ha llamado al DisconnectWebParts método de otro modo. El evento proporciona 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, el evento se puede cancelar. 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 ninguna posibilidad de interrupción, de modo que pueda completar el proceso de limpieza y cierre de 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, tal vez un usuario conecta el control x al control 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 determinado. 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 no se puede cancelar el WebPartsDisconnecting método 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 hay posibilidad de cancelar el evento.

Se aplica a

Consulte también