WebPartManager.WebPartsDisconnecting Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre durante o processo de encerramento da conexão entre WebPart ou controles de servidor anteriormente 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
Comentários
O WebPartsDisconnecting evento é gerado pelo OnWebPartsDisconnecting método e sinaliza o fato de que um usuário clicou em um verbo de desconexão ou o DisconnectWebParts método foi chamado de outra forma. O evento oferece uma oportunidade de cancelar o processo de término de uma conexão antes de ser concluído. Se a conexão for encerrada com êxito, esse evento será seguido pelo WebPartsDisconnected evento .
Os desenvolvedores de página podem adicionar um manipulador 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 é gerado como resultado direto da ação de um usuário que encerra uma conexão, o evento pode ser cancelado. No entanto, há vários cenários em que o evento não pode ser cancelado. O primeiro cenário é que, se um WebPartZone controle for excluído, os WebPart controles que ele contém deverão ser todos fechados, caso contrário, eles ficarão órfãos. Nesse caso, o WebPartManager controle fecha os WebPart controles, não o usuário, e também deve ser capaz de encerrar as conexões de quaisquer controles conectados sem qualquer chance de interrupção, para que ele possa concluir o processo de limpeza e fechamento de todos os controles. 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 no qual o WebPartsDisconnecting evento não pode ser cancelado é quando o ActivateConnections método é chamado (isso é chamado durante cada solicitação para uma página, por exemplo), e há algum tipo de conflito nas conexões existentes em uma página. Por exemplo, talvez um usuário conecte o controle x ao controle y, mas um usuário compartilhado conecta o controle x ao controle z e, no entanto, o controle x não tem permissão para formar várias conexões. Nesse caso, as configurações individuais do usuário para a conexão têm precedência e o WebPartManager controle resolve o conflito chamando o DisconnectWebPart método e encerrando a conexão entre x e z para o usuário específico. Como essa desconexão é essencial para resolver o conflito, por design, o WebPartsDisconnecting evento não pode ser cancelado nesse cenário.
O terceiro cenário no qual o WebPartsDisconnecting método não pode ser cancelado é quando um WebPart controle de servidor ou conectado no momento é excluído ou fechado. Como o controle definitivamente será removido da página, é uma necessidade lógica remover sua conexão. Portanto, quando o WebPartManager controle invoca o DisconnectWebPart método , que, por sua vez, aciona o WebPartsDisconnecting evento, por design, não há possibilidade de cancelar o evento.
