WebPartManager.SelectedWebPartChanging 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在更改网页上 WebPart 或服务器控件当前的选定状态的过程中发生。
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
事件类型
注解
此事件可与 方法结合使用 OnSelectedWebPartChanging 。 页面开发人员可以在代码中创建事件处理程序,方法是将 属性添加到 OnSelectedWebPartChanging
页面中的 <asp:webpartmanager>
元素,并将 特性的值设置为将处理事件的自定义方法的名称。
在开始或结束控件之间的连接过程中,以及开始和结束控件的编辑时,将引发此事件。 有关详细信息,请参阅 OnSelectedWebPartChanging 方法。
通常,当 SelectedWebPartChanging 事件作为用户更改所选控件的操作的直接结果引发时,可以取消该事件。 但是,在某些情况下,事件无法取消。 如果删除了某个 WebPartZone 控件, WebPart 则其包含的控件必须全部关闭,否则它们将成为孤立控件。 在这种情况下,控件 WebPartManager 会 WebPart 关闭控件,而不是用户,并且它必须确定当前选择的控件以及何时更改所选内容而不发生任何中断的可能性,以便它可以完成清理所有控件的过程。 因此,根据设计, SelectedWebPartChanging 此方法在此方案中不能取消。 有关可取消的相关事件,请参阅 事件 WebPartClosing 。