WebPartManager.WebPartsDisconnecting Olay
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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ü
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.
