WebPartManager.WebPartsDisconnecting Olay

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 bir bağlantı kesme fiiline tıkladığını veya yöntemin DisconnectWebParts başka bir şekilde çağrıldığını belirtir. Olay, bağlantı tamamlanmadan önce 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, öğesine özniteliğini OnWebPartsDisconnecting ekleyerek ve özniteliğine <asp:webpartmanager> özel bir yöntem adı atayarak olay için özel bir işleyici ekleyebilir.

Normalde, olay bir 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 bağlı denetimin bağlantılarını kesintiye uğramadan sonlandırabilmesi gerekir. Bu nedenle, tasarım gereği WebPartsDisconnecting yöntemi bu senaryoda iptal edilemez. İptal edilebilen 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ı denetimi x'i y denetimine bağlar, ancak paylaşılan bir kullanıcı denetimi x'i z'yi denetlemek için 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, o anda bağlı olan bir WebPart veya sunucu denetiminin silinmesi veya kapatılmasıdır. Denetim kesinlikle sayfadan kaldırılacağından, bağlantısını kaldırmak mantıklı bir gerekliliktir. Bu nedenle, denetim yöntemini çağırdığında WebPartManagerDisconnectWebPart , bu da olayı tetikler WebPartsDisconnecting , tasarım gereği olayı iptal etme olasılığı yoktur.

Ayrıca bkz.

• OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)
• WebPartsDisconnected
• DisconnectWebParts(WebPartConnection)
• Web Bölümleri Denetimlerini ASP.NET