WebPartManager.WebPartsDisconnecting Událost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Dochází během procesu ukončení připojení mezi dříve připojenými WebPart ovládacími prvky nebo ovládacími prvky serveru.

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

Event Type

WebPartConnectionsCancelEventHandler

Poznámky

Událost WebPartsDisconnecting je vyvolána metodou OnWebPartsDisconnecting a signalizuje skutečnost, že uživatel kliknul na příkaz odpojit nebo DisconnectWebParts metoda byla volána jinak. Událost poskytuje příležitost zrušit proces ukončení připojení před jeho dokončením. Pokud se připojení úspěšně ukončí, za touto událostí WebPartsDisconnected následuje událost.

Vývojáři stránky můžou přidat vlastní obslužnou rutinu události přidáním atributu OnWebPartsDisconnecting do elementu <asp:webpartmanager> a přiřazením vlastního názvu metody atributu.

Za normálních okolností, když WebPartsDisconnecting je událost vyvolána jako přímý výsledek akce uživatele, která ukončí připojení, může být událost zrušena. Existuje však několik scénářů, ve kterých nelze událost zrušit. Prvním scénářem WebPartZone je, že pokud je ovládací prvek odstraněn, WebPart musí být všechny ovládací prvky, které obsahuje, zavřeny, jinak by byly osamocené. V tomto případě WebPartManager ovládací prvek zavře WebPart ovládací prvky, nikoli uživatele, a musí být také schopen ukončit připojení všech připojených ovládacích prvků bez jakéhokoli přerušení, aby mohl dokončit proces čištění a zavření všech ovládacích prvků. Proto v tomto scénáři nelze metodu WebPartsDisconnecting záměrně zrušit. Související událost, kterou je možné zrušit, najdete v této WebPartClosing události.

Druhý scénář, ve kterém WebPartsDisconnecting událost nelze zrušit, je, když ActivateConnections je volána metoda (tato metoda se volá například během každého požadavku na stránku) a v existujících připojeních na stránce dochází k určitému typu konfliktu. Například uživatel připojí ovládací prvek x k ovládacímu prvku y, ale sdílený uživatel připojí ovládací prvek x k ovládacímu prvku z a ovládací prvek x nesmí vytvářet více připojení. V tomto případě má nastavení jednotlivých uživatelů pro připojení přednost a WebPartManager ovládací prvek vyřeší konflikt voláním DisconnectWebPart metody a ukončením spojení mezi x a z pro konkrétního uživatele. Vzhledem k tomu, že toto odpojení je nezbytné pro vyřešení konfliktu, WebPartsDisconnecting záměrně nelze událost v tomto scénáři zrušit.

Třetí scénář, ve kterém nelze metodu WebPartsDisconnecting zrušit, je, když WebPart je ovládací prvek nebo serveru, který je aktuálně připojen, odstraněn nebo zavřen. Vzhledem k tomu, že ovládací prvek se určitě odebere ze stránky, je logické odebrat jeho připojení. Proto když WebPartManager ovládací prvek vyvolá metodu DisconnectWebPart , která zase vyvolá WebPartsDisconnecting událost, záměrně není možné událost zrušit.

Platí pro

Viz také