WebPartManager.OnSelectedWebPartChanging(WebPartCancelEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Levanta o SelectedWebPartChanging evento, que ocorre durante o processo de alteração do WebPart controlo atualmente selecionado.
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
A WebPartCancelEventArgs que contém os dados do evento.
Observações
O OnSelectedWebPartChanging método levanta o SelectedWebPartChanging evento, que ocorre durante o processo de alteração do WebPart controlo atualmente selecionado.
O WebPartManager controlo utiliza este método, e o evento associado, para proporcionar uma oportunidade de cancelar um processo em que o controlo selecionado está a mudar. Por exemplo, o método é chamado dentro do BeginWebPartEditing método, e também dentro do EndWebPartEditing método, para fornecer uma forma de cancelar o processo. Se um utilizador clicar no verbo cancelar num controlo que está a ser editado, o controlo deixa de ser selecionado e quaisquer alterações de edição não são guardadas, porque o OnSelectedWebPartChanging método permite cancelar as alterações de edição.
Note
O método é chamado de forma semelhante durante os métodos que iniciam e terminam o processo de ligar um WebPart controlo a outro controlo, para permitir o cancelamento desse processo.
Os programadores de páginas podem criar um handler personalizado para o SelectedWebPartChanging evento adicionando o OnSelectedWebPartChanging atributo ao <asp:webpartmanager> elemento na marcação declarativa da página e atribuindo ao atributo o nome de um método personalizado.