WebPartManager.OnSelectedWebPartChanging(WebPartCancelEventArgs) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Aciona o evento SelectedWebPartChanging, que ocorre durante o processo de alteração de qual controle WebPart 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 -> unit
Protected Overridable Sub OnSelectedWebPartChanging (e As WebPartCancelEventArgs)

Parâmetros

e
WebPartCancelEventArgs

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.

Observação

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.

Aplica-se a

Confira também