WebPartManager.OnSelectedWebPartChanging(WebPartCancelEventArgs) Método
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.
Gera o SelectedWebPartChanging evento, que ocorre durante o processo de alteração de qual WebPart controle está selecionado no momento.
protected:
virtual void OnSelectedWebPartChanging(System::Web::UI::WebControls::WebParts::WebPartCancelEventArgs ^ e);protected virtual void OnSelectedWebPartChanging(System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs e);abstract member OnSelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs -> unit
override this.OnSelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs -> unitProtected Overridable Sub OnSelectedWebPartChanging (e As WebPartCancelEventArgs)Parâmetros
Um WebPartCancelEventArgs que contém os dados do evento.
Comentários
O OnSelectedWebPartChanging método gera o SelectedWebPartChanging evento, que ocorre durante o processo de alteração de qual WebPart controle está selecionado no momento.
O WebPartManager controle usa esse método e o evento associado para fornecer uma oportunidade de cancelar um processo no qual o controle selecionado está sendo alterado. Por exemplo, o método é chamado dentro do BeginWebPartEditing método e também dentro do EndWebPartEditing método, para fornecer uma maneira de cancelar o processo. Se um usuário clicar no verbo cancelar em um controle que está sendo editado, o controle não será mais selecionado e nenhuma alteração de edição não será salva, pois o OnSelectedWebPartChanging método possibilita cancelar as alterações de edição.
Note
O método é chamado da mesma forma durante os métodos que iniciam e encerram o processo de conexão de um WebPart controle a outro controle, para habilitar o cancelamento desse processo.
Os desenvolvedores de página podem criar um manipulador personalizado para o SelectedWebPartChanging evento adicionando o OnSelectedWebPartChanging atributo ao <asp:webpartmanager> elemento na marcação de página declarativa e atribuindo ao atributo o nome de um método personalizado.