WebPartManager.WebPartsDisconnecting Evento

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Si verifica durante il processo di chiusura della connessione tra controlli WebPart o controlli server connessi in precedenza.

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

Tipo evento

WebPartConnectionsCancelEventHandler

Commenti

L'evento WebPartsDisconnecting viene generato dal OnWebPartsDisconnecting metodo e segnala il fatto che un utente ha fatto clic su un verbo disconnesso oppure il DisconnectWebParts metodo è stato chiamato in caso contrario. L'evento offre l'opportunità di annullare il processo di fine di una connessione prima del completamento. Se la connessione viene terminata correttamente, questo evento viene seguito dall'evento WebPartsDisconnected .

Gli sviluppatori di pagine possono aggiungere un gestore personalizzato per l'evento aggiungendo l'attributo OnWebPartsDisconnecting all'elemento <asp:webpartmanager> e assegnando un nome di metodo personalizzato all'attributo.

In genere, quando l'evento WebPartsDisconnecting viene generato come risultato diretto dell'azione di un utente che termina una connessione, l'evento può essere annullato. Tuttavia, esistono diversi scenari in cui l'evento non può essere annullato. Il primo scenario è, se un WebPartZone controllo viene eliminato, i WebPart controlli che contiene devono essere chiusi, altrimenti sarebbero orfani. In questo caso il WebPartManager controllo chiude i WebPart controlli, non l'utente e deve anche essere in grado di terminare le connessioni di tutti i controlli connessi senza alcuna probabilità di interruzione, in modo che possa completare il processo di pulizia e chiusura di tutti i controlli. Pertanto, per progettazione il WebPartsDisconnecting metodo non può essere annullato in questo scenario. Per un evento correlato che può essere annullato, vedere l'evento WebPartClosing .

Il secondo scenario in cui l'evento non può essere annullato è quando il WebPartsDisconnectingActivateConnections metodo viene chiamato (questo viene chiamato durante ogni richiesta a una pagina, ad esempio), ed è presente un tipo di conflitto nelle connessioni esistenti in una pagina. Ad esempio, un utente connette il controllo x al controllo y, ma un utente condiviso connette il controllo x al controllo z, ma il controllo x non è consentito formare più connessioni. In questo caso, le impostazioni dell'utente singolo per la connessione hanno la precedenza e il controllo risolve il WebPartManager conflitto chiamando il DisconnectWebPart metodo e terminando la connessione tra x e z per l'utente specifico. Poiché questa disconnessione è essenziale per risolvere il conflitto, non è possibile annullare l'evento WebPartsDisconnecting in questo scenario.

Il terzo scenario in cui il WebPartsDisconnecting metodo non può essere annullato è quando un WebPart controllo o server attualmente connesso viene eliminato o chiuso. Poiché il controllo verrà sicuramente rimosso dalla pagina, è una necessità logica di rimuovere la connessione. Pertanto, quando il controllo richiama il WebPartManagerDisconnectWebPart metodo, che a sua volta genera l'evento WebPartsDisconnecting , per progettazione non è possibile annullare l'evento.

Si applica a

Vedi anche