WebPartManager.WebPartsDisconnecting Evento

Definizione

Si verifica durante il processo di chiusura della connessione tra controlli WebPart o controlli server connessi in precedenza.Occurs during the process of ending the connection between previously connected WebPart or server controls.

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 

Commenti

L' WebPartsDisconnecting evento viene generato OnWebPartsDisconnecting dal metodo e segnala il fatto che un utente ha fatto clic su un verbo di disconnessione oppure il DisconnectWebParts metodo è stato chiamato in altro modo.The WebPartsDisconnecting event is raised by the OnWebPartsDisconnecting method, and it signals the fact that a user has clicked a disconnect verb, or the DisconnectWebParts method has otherwise been called. L'evento consente di annullare il processo di chiusura di una connessione prima che venga completata.The event provides an opportunity to cancel the process of ending a connection before it is complete. Se la connessione viene terminata correttamente, questo evento è seguito dall' WebPartsDisconnected evento.If the connection is ended successfully, this event is followed by the WebPartsDisconnected event.

Gli sviluppatori di pagine possono aggiungere un gestore personalizzato per l'evento aggiungendo OnWebPartsDisconnecting l'attributo <asp:webpartmanager> all'elemento e assegnando un nome di metodo personalizzato all'attributo.Page developers can add a custom handler for the event by adding the OnWebPartsDisconnecting attribute to the <asp:webpartmanager> element, and assigning a custom method name to the attribute.

In genere, quando WebPartsDisconnecting l'evento viene generato come risultato diretto di un'azione dell'utente che termina una connessione, l'evento può essere annullato.Normally, when the WebPartsDisconnecting event is raised as a direct result of a user's action that ends a connection, the event can be cancelled. Tuttavia, esistono diversi scenari in cui l'evento non può essere annullato.However, there are several scenarios in which the event cannot be cancelled. Il primo scenario è, se un WebPartZone controllo viene eliminato, i WebPart controlli in esso contenuti devono essere tutti chiusi; in caso contrario, verrebbero isolati.The first scenario is, if a WebPartZone control is deleted, the WebPart controls it contains must all be closed, otherwise they would be orphaned. In questo caso il WebPartManager controllo chiude i WebPart controlli e 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 da poter completare il processo di pulizia e chiusura tutti i controlli.In this case the WebPartManager control closes the WebPart controls, not the user, and it must also be able to terminate the connections of any connected controls without any chance of interruption, so that it can complete the process of cleaning up and closing all the controls. Pertanto, in base alla WebPartsDisconnecting progettazione, il metodo non può essere annullato in questo scenario.Therefore, by design the WebPartsDisconnecting method cannot be cancelled in this scenario. Per un evento correlato che può essere annullato WebPartClosing , vedere l'evento.For a related event that can be cancelled, see the WebPartClosing event.

Il secondo scenario in cui l' WebPartsDisconnecting evento non può essere annullato ActivateConnections è quando viene chiamato il metodo (chiamato durante ogni richiesta a una pagina, ad esempio) e si verifica un conflitto tra le connessioni esistenti in una pagina.The second scenario in which the WebPartsDisconnecting event cannot be cancelled is when the ActivateConnections method is called (this called during each request to a page, for example), and there is some type of conflict in the existing connections on a page. Ad esempio, un utente può connettere il controllo x al controllo y, ma un utente condiviso connette il controllo x al controllo z, ma il controllo x non è autorizzato a creare più connessioni.For example, perhaps a user connects control x to control y, but a shared user connects control x to control z, and yet control x is not allowed to form multiple connections. In questo caso, le impostazioni del singolo utente 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.In this case, the individual user's settings for the connection take precedence, and the WebPartManager control resolves the conflict by calling the DisconnectWebPart method and ending the connection between x and z for the particular user. Poiché questa disconnessione è essenziale per la risoluzione del conflitto, la progettazione dell' WebPartsDisconnecting evento non può essere annullata in questo scenario.Because this disconnection is essential to resolving the conflict, by design the WebPartsDisconnecting event cannot be cancelled in this scenario.

Il terzo scenario in cui il WebPartsDisconnecting metodo non può essere annullato WebPart si verifica quando un controllo server o attualmente connesso viene eliminato o chiuso.The third scenario in which the WebPartsDisconnecting method cannot be cancelled is when a WebPart or server control that is currently connected is either deleted or closed. Poiché il controllo verrà rimosso definitivamente dalla pagina, è una necessità logica di rimuovere la connessione.Because the control is definitely going to be removed from the page, it is a logical necessity to remove its connection. Pertanto, quando il WebPartManager controllo richiama il DisconnectWebPart metodo, che a sua volta genera l' WebPartsDisconnecting evento, per progettazione non è possibile annullare l'evento.Therefore, when the WebPartManager control invokes the DisconnectWebPart method, which in turn raises the WebPartsDisconnecting event, by design there is no possibility of canceling the event.

Si applica a

Vedi anche