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

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

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