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 zgłaszane przez metodę OnWebPartsDisconnecting i sygnalizuje fakt, że użytkownik kliknął czasownik rozłączenia lub DisconnectWebParts metoda została wywołana. Zdarzenie umożliwia anulowanie procesu zakończenia połączenia przed jego ukończeniem. Jeśli połączenie zostanie pomyślnie zakończone, to zdarzenie następuje WebPartsDisconnected po 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, gdy WebPartsDisconnecting zdarzenie jest zgłaszane 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ą oddzielone. W takim przypadku kontrolka WebPartManager zamyka kontrolki WebPart , a nie użytkownika i musi być również w stanie zakończyć połączenia wszystkich podłączonych kontrolek bez jakichkolwiek szans na przerwę, aby można było ukończyć proces czyszczenia i zamykania wszystkich kontrolek. W związku z tym zgodnie z WebPartsDisconnecting projektem nie można anulować metody w tym scenariuszu. Aby uzyskać powiązane zdarzenie, które można anulować, zobacz WebPartClosing zdarzenie.

Drugim scenariuszem, w którym WebPartsDisconnecting nie można anulować zdarzenia, jest ActivateConnections wywołanie metody (wywoływanej podczas każdego żądania na przykład do strony) i występuje jakiś typ konfliktu w istniejących połączeniach na stronie. Na przykład użytkownik łączy kontrolkę x z kontrolką y, ale współużytkowany 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, wywołując DisconnectWebPart metodę i kończąc połączenie między x i z dla określonego użytkownika. Ponieważ to rozłączenie jest niezbędne do rozwiązania konfliktu, zgodnie z projektem WebPartsDisconnecting nie można anulować zdarzenia w tym scenariuszu.

Trzecim scenariuszem, w którym WebPartsDisconnecting nie można anulować metody, jest usunięcie WebPart 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ż