WebPartManager.WebPartsDisconnecting Olay

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Daha önce bağlı WebPart olan veya sunucu denetimleri arasındaki bağlantıyı sonlandırma işlemi sırasında gerçekleşir.

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

Olay Türü

WebPartConnectionsCancelEventHandler

Açıklamalar

Olayı WebPartsDisconnecting yöntemi tarafından OnWebPartsDisconnecting oluşturulur ve bir kullanıcının bağlantısı kes fiiline tıkladığını veya yöntemin DisconnectWebParts başka bir şekilde çağrıldığını belirtir. Olay, bağlantı tamamlanmadan önce bağlantıyı sonlandırma işlemini iptal etme fırsatı sağlar. Bağlantı başarıyla sonlandırılırsa, bu olayı olay izler WebPartsDisconnected .

Sayfa geliştiricileri, özniteliğini öğesine ekleyerek OnWebPartsDisconnecting ve özniteliğine <asp:webpartmanager> özel bir yöntem adı atayarak olay için özel bir işleyici ekleyebilir.

Normalde, olay kullanıcının bağlantıyı sonlandıran eyleminin doğrudan bir sonucu olarak ortaya çıktığında WebPartsDisconnecting , olay iptal edilebilir. Ancak, olayın iptal edilemediği birkaç senaryo vardır. İlk senaryo, bir WebPartZone denetim silinirse, içerdiği denetimlerin tümünün WebPart kapatılması gerektiğidir, aksi takdirde yalnız bırakılırlar. Bu durumda WebPartManager denetim, kullanıcıyı değil denetimleri kapatır WebPart ve ayrıca tüm denetimleri temizleme ve kapatma işlemini tamamlayabilmesi için herhangi bir kesinti olasılığı olmadan bağlı denetimlerin bağlantılarını sonlandırabilmesi gerekir. Bu nedenle, tasarım gereği WebPartsDisconnecting yöntem bu senaryoda iptal edilemez. İptal edilebilecek ilgili bir olay için olaya bakın WebPartClosing .

Olayın iptal edilemediği ikinci senaryo WebPartsDisconnecting , yöntemin ActivateConnections çağrıldığı (örneğin, bir sayfaya yapılan her istek sırasında çağrılır) ve bir sayfadaki mevcut bağlantılarda bir tür çakışma olmasıdır. Örneğin, bir kullanıcı y'yi denetlemek için x denetimini bağlar, ancak paylaşılan bir kullanıcı z'yi denetlemek için x denetimini bağlar ve x denetiminin birden çok bağlantı oluşturmasına izin verilmez. Bu durumda, tek tek kullanıcının bağlantı ayarları önceliklidir ve WebPartManager denetim, yöntemini çağırarak DisconnectWebPart ve belirli bir kullanıcı için x ile z arasındaki bağlantıyı sonlandırarak çakışmayı çözer. Bu bağlantı kesilmesi çakışmayı çözmek için gerekli olduğundan, tasarım WebPartsDisconnecting gereği olay bu senaryoda iptal edilemez.

Yöntemin WebPartsDisconnecting iptal edilemediği üçüncü senaryo, şu anda bağlı olan bir WebPart veya sunucu denetiminin silindiği veya kapatıldığı senaryodur. Denetim kesinlikle sayfadan kaldırılacağından, bağlantısını kaldırmak mantıklı bir zorunluluktur. Bu nedenle, denetim yöntemi çağırdığında WebPartManagerDisconnectWebPart , bu da olayı tetikler WebPartsDisconnecting , tasarım gereği olayı iptal etme olasılığı yoktur.

Şunlara uygulanır

Ayrıca bkz.