Udostępnij za pośrednictwem

WebPartManager.WebPartsDisconnecting Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Występuje podczas procesu kończenia połączenia między wcześniej połączonymi WebPart lub kontrolkami serwera.

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

Typ zdarzenia

WebPartConnectionsCancelEventHandler

Uwagi

Zdarzenie WebPartsDisconnecting jest wywoływane przez metodę OnWebPartsDisconnecting i sygnalizuje fakt, że użytkownik kliknął czasownik rozłączenia lub DisconnectWebParts metoda została wywołana. Zdarzenie zapewnia możliwość anulowania procesu zakończenia połączenia przed jego ukończeniem. Jeśli połączenie zostało zakończone pomyślnie, to zdarzenie następuje po WebPartsDisconnected zdarzeniu.

Deweloperzy stron mogą dodać niestandardową procedurę obsługi dla zdarzenia, dodając OnWebPartsDisconnecting atrybut do <asp:webpartmanager> elementu i przypisując niestandardową nazwę metody do atrybutu.

Zwykle, WebPartsDisconnecting gdy zdarzenie jest wywoływane bezpośrednio w wyniku akcji użytkownika, która kończy połączenie, zdarzenie można anulować. Istnieje jednak kilka scenariuszy, w których nie można anulować zdarzenia. Pierwszy scenariusz polega na tym, że jeśli kontrolka WebPartZone zostanie usunięta, kontrolki, które zawiera, WebPart muszą zostać zamknięte. W przeciwnym razie zostaną one oddzielone. W takim przypadku kontrolka WebPartManager zamyka kontrolki WebPart , a nie użytkownika i musi być również w stanie przerwać połączenia wszystkich połączonych kontrolek bez żadnych szans na przerwanie działania, dzięki czemu może zakończyć proces czyszczenia i zamykania wszystkich kontrolek. W związku z tym przez projekt WebPartsDisconnecting nie można anulować metody w tym scenariuszu. Aby uzyskać powiązane zdarzenie, które można anulować, zobacz WebPartClosing zdarzenie.

Drugi scenariusz, w którym WebPartsDisconnecting nie można anulować zdarzenia, jest ActivateConnections wywoływana metoda (wywoływana podczas każdego żądania na stronie, na przykład) i występuje jakiś typ konfliktu w istniejących połączeniach na stronie. Na przykład być może użytkownik łączy kontrolkę x z kontrolką y, ale udostępniony użytkownik łączy kontrolkę x z, a jednak kontrolka x nie może tworzyć wielu połączeń. W takim przypadku ustawienia poszczególnych użytkowników dla połączenia mają pierwszeństwo, a WebPartManager kontrolka rozwiązuje konflikt przez wywołanie DisconnectWebPart metody i zakończenie połączenia między x i z dla określonego użytkownika. Ponieważ to rozłączenie jest niezbędne do rozwiązania konfliktu, WebPartsDisconnecting w tym scenariuszu nie można anulować zdarzenia.

Trzecim scenariuszem, w którym WebPartsDisconnecting nie można anulować metody, jest WebPart usunięcie lub zamknięcie kontrolki serwera, która jest obecnie połączona. Ponieważ kontrolka na pewno zostanie usunięta ze strony, jest to logiczna konieczność usunięcia połączenia. W związku z tym, gdy kontrolka WebPartManager wywołuje metodę DisconnectWebPart , która z kolei zgłasza WebPartsDisconnecting zdarzenie, zgodnie z projektem nie ma możliwości anulowania zdarzenia.

Dotyczy

Zobacz też