WebPartManager.WebPartsDisconnecting Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre durante o processo de terminar a ligação entre controlos previamente conectados WebPart ou do servidor.
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
Observações
O WebPartsDisconnecting evento é levantado pelo OnWebPartsDisconnecting método e sinaliza o facto de que um utilizador clicou num verbo de desconexão, ou que o DisconnectWebParts método foi de outra forma chamado. O evento oferece uma oportunidade para cancelar o processo de terminar uma ligação antes de esta estar concluída. Se a ligação terminar com sucesso, este evento é seguido pelo WebPartsDisconnected evento.
Os programadores de páginas podem adicionar um handler personalizado para o evento, adicionando o OnWebPartsDisconnecting atributo ao <asp:webpartmanager> elemento e atribuindo um nome de método personalizado ao atributo.
Normalmente, quando o WebPartsDisconnecting evento é ativado como resultado direto da ação de um utilizador que termina uma ligação, o evento pode ser cancelado. No entanto, existem vários cenários em que o evento não pode ser cancelado. O primeiro cenário é: se um WebPartZone controlo for eliminado, os WebPart controlos que contém devem ser todos fechados, caso contrário ficariam órfãos. Neste caso, o controlo WebPartManager fecha os WebPart controlos, não o utilizador, e deve também ser capaz de terminar as ligações de quaisquer controlos ligados sem qualquer hipótese de interrupção, para que possa completar o processo de limpeza e encerramento de todos os controlos. Portanto, por design, o WebPartsDisconnecting método não pode ser cancelado neste cenário. Para um evento relacionado que pode ser cancelado, consulte o WebPartClosing evento.
O segundo cenário em que o WebPartsDisconnecting evento não pode ser cancelado é quando o ActivateConnections método é chamado (isto é chamado durante cada pedido a uma página, por exemplo) e existe algum tipo de conflito nas ligações existentes numa página. Por exemplo, talvez um utilizador ligue o controlo x ao controlo y, mas um utilizador partilhado liga o controlo x ao controlo z, e ainda assim o controlo x não pode formar múltiplas ligações. Neste caso, as definições individuais do utilizador para a ligação têm precedência, e o WebPartManager controlo resolve o conflito chamando o DisconnectWebPart método e terminando a ligação entre x e z para o utilizador em particular. Como esta desconexão é essencial para resolver o conflito, por design o WebPartsDisconnecting evento não pode ser cancelado neste cenário.
O terceiro cenário em que o WebPartsDisconnecting método não pode ser cancelado é quando um WebPart ou um controlo de servidor atualmente ligado é eliminado ou fechado. Como o controlo vai certamente ser removido da página, é lógico remover a sua ligação. Portanto, quando o controlo WebPartManager invoca o DisconnectWebPart método, que por sua vez eleva o WebPartsDisconnecting evento, por design não há possibilidade de cancelar o evento.
