WebPartManager.WebPartsDisconnecting Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит во время процесса завершения подключения между ранее подключенными WebPart или серверными элементами управления.
public:
event System::Web::UI::WebControls::WebParts::WebPartConnectionsCancelEventHandler ^ WebPartsDisconnecting;public event System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler WebPartsDisconnecting;member this.WebPartsDisconnecting : System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler Public Custom Event WebPartsDisconnecting As WebPartConnectionsCancelEventHandler Тип события
Комментарии
Событие WebPartsDisconnecting вызывается методом OnWebPartsDisconnecting и сообщает о том, что пользователь щелкнул команду отключения или DisconnectWebParts метод был вызван другим способом. Событие дает возможность отменить процесс завершения подключения до его завершения. Если подключение успешно завершено, за этим событием WebPartsDisconnected следует событие .
Разработчики страниц могут добавить пользовательский обработчик для события, добавив OnWebPartsDisconnecting атрибут в <asp:webpartmanager> элемент и назначив ему имя настраиваемого метода.
Как правило, если WebPartsDisconnecting событие возникает в результате действия пользователя, которое завершает подключение, событие может быть отменено. Однако существует несколько сценариев, в которых событие не может быть отменено. Первый сценарий заключается в WebPartZone том, что при удалении элемента управления все содержащиеся в WebPart нем элементы управления должны быть закрыты, в противном случае они будут потеряны. В этом случае WebPartManager элемент управления закрывает WebPart элементы управления, а не пользователя, и он также должен иметь возможность прервать подключения любых подключенных элементов управления без какой-либо вероятности прерывания, чтобы он мог завершить процесс очистки и закрытия всех элементов управления. Поэтому по умолчанию WebPartsDisconnecting метод нельзя отменить в этом сценарии. Сведения о связанном событии, которое можно отменить, см. в этом событии WebPartClosing .
Второй сценарий, в котором WebPartsDisconnecting событие не может быть отменено, — это ActivateConnections вызов метода (например, при каждом запросе к странице) и наличие определенного типа конфликта в существующих подключениях на странице. Например, возможно, пользователь подключает элемент управления x для управления y, а общий пользователь подключает элемент управления x для управления z, и при этом элементу управления x не разрешено создавать несколько подключений. В этом случае параметры отдельного пользователя для подключения имеют приоритет, а WebPartManager элемент управления разрешает конфликт, вызывая DisconnectWebPart метод и заканчивая соединение между x и z для конкретного пользователя. Так как это отключение имеет важное значение для разрешения конфликта, по умолчанию WebPartsDisconnecting событие не может быть отменено в этом сценарии.
Третий сценарий, в котором WebPartsDisconnecting метод не может быть отменен, — это удаление или закрытие серверного WebPart элемента управления или , который в данный момент подключен. Так как элемент управления, безусловно, будет удален со страницы, это логическая необходимость удалить его соединение. Таким образом, когда WebPartManager элемент управления вызывает DisconnectWebPart метод , который, в свою очередь, вызывает WebPartsDisconnecting событие, по умолчанию невозможно отменить событие.
