WebPartManager.SelectedWebPartChanging Evento

Definição

Ocorre durante o processo de alteração de qual WebPart ou o controlo do servidor está atualmente selecionado numa página Web.

public:
 event System::Web::UI::WebControls::WebParts::WebPartCancelEventHandler ^ SelectedWebPartChanging;
public event System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler SelectedWebPartChanging;
member this.SelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler 
Public Custom Event SelectedWebPartChanging As WebPartCancelEventHandler 

Tipo de Evento

Observações

Este evento pode ser usado em conjunto com o OnSelectedWebPartChanging método. Os programadores de páginas podem criar um gestor de eventos no seu código adicionando o OnSelectedWebPartChanging atributo ao <asp:webpartmanager> elemento numa página e definindo o valor do atributo para o nome de um método personalizado que irá gerir o evento.

Este evento surge durante o processo de iniciar ou terminar uma ligação entre controlos, e ao iniciar e terminar uma edição de um controlo. Para mais detalhes, consulte o OnSelectedWebPartChanging método.

Normalmente, quando o SelectedWebPartChanging evento é ativado como resultado direto de uma ação do utilizador que altera o controlo selecionado, o evento pode ser cancelado. No entanto, existe um cenário em que o evento não pode ser cancelado. Se um WebPartZone controlo for eliminado, todos os WebPart controlos que contém devem ser fechados, caso contrário ficarão órfãos. Neste caso, o controlo WebPartManager fecha os WebPart controlos, não o utilizador, e deve determinar qual o controlo atualmente selecionado e quando alterar a seleção sem qualquer hipótese de interrupção, para poder completar o processo de limpeza de todos os controlos. Portanto, por design, o SelectedWebPartChanging método não pode ser cancelado neste cenário. Para um evento relacionado que pode ser cancelado, consulte o WebPartClosing evento.

Aplica-se a

Ver também