Поделиться через

WebPartManager.WebPartsDisconnecting Событие

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Происходит во время процесса завершения подключения между ранее подключенными 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

Тип события

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 событие, по умолчанию невозможно отменить событие.

Применяется к

См. также раздел