WebPartManager.WebPartsDisconnecting Evento

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 encerramento 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, todos os WebPart controles que ele contém deverão ser 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 em que o WebPartsDisconnecting evento não pode ser cancelado é quando o ActivateConnections método é chamado (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 do usuário individual 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 em que o WebPartsDisconnecting método não pode ser cancelado é quando um WebPart controle de servidor ou que está 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, gera o WebPartsDisconnecting evento , por design, não há nenhuma possibilidade de cancelar o evento.

Aplica-se a

Confira também

• OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)
• WebPartsDisconnected
• DisconnectWebParts(WebPartConnection)
• Controles de Web Parts do ASP.NET