EditorZoneBase.OnDisplayModeChanged Methode

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Löst das DisplayModeChanged-Ereignis aus und löscht alle EditorPart-Steuerelemente und die untergeordneten Steuerelemente in der Zone, um den Wechsel der Webseite in den oder aus dem Bearbeitungsanzeigemodus vorzubereiten.

protected:
 override void OnDisplayModeChanged(System::Object ^ sender, System::Web::UI::WebControls::WebParts::WebPartDisplayModeEventArgs ^ e);

protected override void OnDisplayModeChanged (object sender, System.Web.UI.WebControls.WebParts.WebPartDisplayModeEventArgs e);

override this.OnDisplayModeChanged : obj * System.Web.UI.WebControls.WebParts.WebPartDisplayModeEventArgs -> unit

Protected Overrides Sub OnDisplayModeChanged (sender As Object, e As WebPartDisplayModeEventArgs)

Parameter

sender

Object

Ein Object, das das DisplayModeChanged-Ereignis auslöst.

e

WebPartDisplayModeEventArgs

Ein WebPartDisplayModeEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die OnDisplayModeChanged -Methode in einer abgeleiteten Klasse überschrieben wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des EditorZoneBase Themas Klassenübersicht.

Die benutzerdefinierte Editorzone wird von der EditorZone -Klasse abgeleitet, sodass sie mit einer Zonenvorlage im deklarativen Markup der Webseite verwendet werden kann. Die benutzerdefinierte Klasse überschreibt die OnDisplayModeChanged -Methode, legt die Hintergrundfarbe der Zone auf eine angegebene Farbe fest und ruft dann die Basismethode auf, die alle untergeordneten Steuerelemente und EditorPart Steuerelemente zerstört, um in den Bearbeitungsmodus einzusteigen oder den Anzeigemodus zu beenden.

protected override void OnDisplayModeChanged(object sender, 
  WebPartDisplayModeEventArgs e)
{
  this.BackColor = Color.LightGray;
  base.OnDisplayModeChanged(sender, e);
}

Protected Overrides Sub OnDisplayModeChanged(ByVal sender _
  As Object, ByVal e As WebPartDisplayModeEventArgs)
  Me.BackColor = Color.LightGray
  MyBase.OnDisplayModeChanged(sender, e)
End Sub

Wenn Sie die Seite in einem Browser laden, können Sie im Dropdownlistensteuerelement Bearbeitungsmodus auswählen, um in den Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste eines der Steuerelemente klicken und dann auf Bearbeiten klicken, um das ausgewählte Steuerelement zu bearbeiten. Wenn das Steuerelement und die EditorZone Bearbeitungsbenutzeroberfläche (UI) sichtbar sind, können Sie sehen, dass die Zone die im Code angegebene Hintergrundfarbe aufweist.

Hinweise

Die OnDisplayModeChanged -Methode stellt eine Implementierung für die Basismethode in der ToolZone -Klasse bereit.

Der Standard Zweck der OnDisplayModeChanged -Methode besteht darin, eine Webseite vorzubereiten, um in den Bearbeitungsmodus zu wechseln oder diesen zu beenden. Die -Methode zerstört alle in der Zone enthaltenen Steuerelemente und ruft dann die Basismethode auf, die das DisplayModeChanged -Ereignis im WebPartManager -Steuerelement auslöst.

Hinweise für Vererber

Die OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs) Methode kann in einem benutzerdefinierten Editorzonensteuerelement, das von der EditorZoneBase -Klasse oder der EditorZone -Klasse erbt, überschrieben oder programmgesteuert aufgerufen werden.

Weitere Informationen

• ASP.NET Webparts-Steuerelemente