WebPartManager.OnSelectedWebPartChanging(WebPartCancelEventArgs) Methode

Definition

Löst das SelectedWebPartChanging-Ereignis aus, das während des Prozesses eintritt, bei dem das derzeit ausgewählte WebPart-Steuerelement geändert wird.

protected:
 virtual void OnSelectedWebPartChanging(System::Web::UI::WebControls::WebParts::WebPartCancelEventArgs ^ e);
protected virtual void OnSelectedWebPartChanging (System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs e);
abstract member OnSelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs -> unit
override this.OnSelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventArgs -> unit
Protected Overridable Sub OnSelectedWebPartChanging (e As WebPartCancelEventArgs)

Parameter

e
WebPartCancelEventArgs

Ein WebPartCancelEventArgs, das die Ereignisdaten enthält.

Hinweise

Die OnSelectedWebPartChanging -Methode löst das SelectedWebPartChanging -Ereignis aus, das beim Ändern WebPart des aktuell ausgewählten Steuerelements auftritt.

Das WebPartManager Steuerelement verwendet diese Methode und das zugehörige Ereignis, um eine Möglichkeit zum Abbrechen eines Prozesses zu bieten, in dem sich das ausgewählte Steuerelement ändert. Beispielsweise wird die -Methode innerhalb der BeginWebPartEditing -Methode und auch innerhalb der EndWebPartEditing -Methode aufgerufen, um eine Möglichkeit zum Abbrechen des Prozesses bereitzustellen. Wenn ein Benutzer in einem Steuerelement, das bearbeitet wird, auf das Verb abbrechen klickt, wird das Steuerelement nicht mehr ausgewählt, und bearbeitungsänderungen werden nicht gespeichert, da die OnSelectedWebPartChanging Methode das Abbrechen der Bearbeitungsänderungen ermöglicht.

Hinweis

Die -Methode wird auch während der Methoden aufgerufen, die den Prozess der Verbindung eines Steuerelements mit einem WebPart anderen Steuerelement beginnen und beenden, um das Abbrechen dieses Prozesses zu aktivieren.

Seitenentwickler können einen benutzerdefinierten Handler für das SelectedWebPartChanging Ereignis erstellen, indem sie dem OnSelectedWebPartChanging -Element im deklarativen Seitenmarkup das <asp:webpartmanager> Attribut hinzufügen und dem Attribut den Namen einer benutzerdefinierten Methode zuweisen.

Gilt für:

Weitere Informationen