WebPartManager.WebPartsDisconnecting Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Commenti
L'evento WebPartsDisconnecting viene generato dal OnWebPartsDisconnecting metodo e segnala il fatto che un utente ha fatto clic su un verbo di disconnessione oppure che il DisconnectWebParts metodo è stato altrimenti chiamato. L'evento offre l'opportunità di annullare il processo di terminazione 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. Esistono tuttavia diversi scenari in cui l'evento non può essere annullato. Il primo scenario è che, se un WebPartZone controllo viene eliminato, i WebPart controlli che contiene devono essere tutti chiusi, altrimenti verranno 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 possibilità di interruzione, in modo che possa completare il processo di pulizia e chiusura di tutti i controlli. Pertanto, per impostazione predefinita non è possibile annullare il WebPartsDisconnecting metodo in questo scenario. Per un evento correlato che può essere annullato, vedere l'evento WebPartClosing .
Il secondo scenario in cui l'evento WebPartsDisconnecting non può essere annullato è quando il ActivateConnections metodo viene chiamato (questo metodo viene chiamato durante ogni richiesta a una pagina, ad esempio) ed esiste 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 e tuttavia il controllo x non è autorizzato a formare più connessioni. In questo caso, le impostazioni dell'utente singolo per la connessione hanno la precedenza e il WebPartManager controllo risolve il 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, per impostazione predefinita l'evento WebPartsDisconnecting non può essere annullato 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.
