WebPartManager.SelectedWebPartChanging Evento

Definizione

Si verifica durante il processo di modifica del controllo WebPart o del controllo server correntemente selezionato in una pagina Web.Occurs during the process of changing which WebPart or server control is currently selected on a Web page.

public:
 event System::Web::UI::WebControls::WebParts::WebPartCancelEventHandler ^ SelectedWebPartChanging;
public event System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler SelectedWebPartChanging;
member this.SelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler 
Public Custom Event SelectedWebPartChanging As WebPartCancelEventHandler 

Commenti

Questo evento può essere utilizzato in combinazione con il OnSelectedWebPartChanging metodo.This event can be used in conjunction with the OnSelectedWebPartChanging method. Gli sviluppatori di pagine possono creare un gestore eventi nel codice aggiungendo l' OnSelectedWebPartChanging attributo <asp:webpartmanager> all'elemento in una pagina e impostando il valore dell'attributo sul nome di un metodo personalizzato che gestirà l'evento.Page developers can create an event handler in their code by adding the OnSelectedWebPartChanging attribute to the <asp:webpartmanager> element in a page, and setting the value of the attribute to the name of a custom method that will handle the event.

Questo evento viene generato durante il processo di inizio o fine di una connessione tra i controlli e quando inizia e termina una modifica di un controllo.This event is raised during the process of beginning or ending a connection between controls, and when beginning and ending an edit of a control. Per informazioni dettagliate, vedere OnSelectedWebPartChanging il metodo.For details, see the OnSelectedWebPartChanging method.

In genere, quando SelectedWebPartChanging l'evento viene generato come risultato diretto di un'azione dell'utente che modifica il controllo selezionato, l'evento può essere annullato.Normally, when the SelectedWebPartChanging event is raised as a direct result of a user's action that changes the selected control, the event can be cancelled. Tuttavia, esiste uno scenario in cui l'evento non può essere annullato.However, there is a scenario in which the event cannot be cancelled. Se un WebPartZone controllo viene eliminato, i WebPart controlli in esso contenuti devono essere tutti chiusi; in caso contrario, verrebbero isolati.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 determinare il controllo attualmente selezionato e quando modificare la selezione senza alcuna possibilità di interruzione, in modo da poter completare il processo di pulizia tutti i controlli.In this case the WebPartManager control closes the WebPart controls, not the user, and it must determine which control is currently selected and when to change the selection without any chance of interruption, so that it can complete the process of cleaning up all the controls. Pertanto, in base alla SelectedWebPartChanging progettazione, il metodo non può essere annullato in questo scenario.Therefore, by design the SelectedWebPartChanging 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.

Si applica a

Vedi anche