WebPartManager.WebPartsDisconnecting Événement

Définition

Se produit au cours du processus de clôture de connexion entre des WebPart ou contrôles serveur précédemment connectés.

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 

Type d'événement

Remarques

L’événement WebPartsDisconnecting est déclenché par la OnWebPartsDisconnecting méthode et signale le fait qu’un utilisateur a cliqué sur un verbe de déconnexion ou que la DisconnectWebParts méthode a été appelée. L’événement offre la possibilité d’annuler le processus de fin d’une connexion avant qu’il ne soit terminé. Si la connexion se termine correctement, cet événement est suivi de l’événement WebPartsDisconnected .

Les développeurs de pages peuvent ajouter un gestionnaire personnalisé pour l’événement en ajoutant l’attribut OnWebPartsDisconnecting à l’élément <asp:webpartmanager> et en affectant un nom de méthode personnalisé à l’attribut.

Normalement, lorsque l’événement WebPartsDisconnecting est déclenché en tant que résultat direct de l’action d’un utilisateur qui met fin à une connexion, l’événement peut être annulé. Toutefois, il existe plusieurs scénarios dans lesquels l’événement ne peut pas être annulé. Le premier scénario est que, si un WebPartZone contrôle est supprimé, les WebPart contrôles qu’il contient doivent tous être fermés, sinon ils seraient orphelins. Dans ce cas, le WebPartManager contrôle ferme les WebPart contrôles, et non l’utilisateur, et il doit également être en mesure d’arrêter les connexions de tous les contrôles connectés sans risque d’interruption, afin qu’il puisse terminer le processus de nettoyage et de fermeture de tous les contrôles. Par conséquent, par conception, la WebPartsDisconnecting méthode ne peut pas être annulée dans ce scénario. Pour un événement associé qui peut être annulé, consultez l’événement WebPartClosing .

Le deuxième scénario dans lequel l’événement WebPartsDisconnecting ne peut pas être annulé est lorsque la ActivateConnections méthode est appelée (ce qui est appelé lors de chaque requête à une page, par exemple) et qu’il existe un type de conflit dans les connexions existantes sur une page. Par exemple, un utilisateur connecte peut-être le contrôle x au contrôle y, mais un utilisateur partagé connecte le contrôle x au contrôle z, et pourtant le contrôle x n’est pas autorisé à former plusieurs connexions. Dans ce cas, les paramètres de l’utilisateur individuel pour la connexion sont prioritaires, et le WebPartManager contrôle résout le conflit en appelant la DisconnectWebPart méthode et en mettant fin à la connexion entre x et z pour l’utilisateur particulier. Étant donné que cette déconnexion est essentielle à la résolution du conflit, par conception, l’événement WebPartsDisconnecting ne peut pas être annulé dans ce scénario.

Le troisième scénario dans lequel la WebPartsDisconnecting méthode ne peut pas être annulée est lorsqu’un WebPart contrôle serveur ou actuellement connecté est supprimé ou fermé. Étant donné que le contrôle va certainement être supprimé de la page, il est logiquement nécessaire de supprimer sa connexion. Par conséquent, lorsque le WebPartManager contrôle appelle la DisconnectWebPart méthode, ce qui à son tour déclenche l’événement WebPartsDisconnecting , il n’est pas possible d’annuler l’événement.

S’applique à

Voir aussi