WebPartZoneBase.DeleteVerb Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer die WebPart-Steuerelemente in einer Zone löschen können.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ DeleteVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb DeleteVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DeleteVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property DeleteVerb As WebPartVerb

Eigenschaftswert

WebPartVerb

Ein WebPartVerb, mit dem Endbenutzer WebPart-Steuerelemente löschen können.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der DeleteVerb -Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Damit das Codebeispiel funktioniert, benötigen Sie den gesamten Code aus dem Abschnitt Beispiel der HelpVerb -Eigenschaft.

Der folgende Teil des Codebeispiels stammt aus der partiellen Klasse und enthält den Code, der umschalten kann, ob das Löschverb aktiviert oder deaktiviert ist.

protected void CheckBoxList1_SelectedItemIndexChanged(Object sender, EventArgs e)
{
  foreach (ListItem item in CheckBoxList1.Items)
  {
    WebPartVerb theVerb;
    switch (item.Value)
    {
      case "close":
        theVerb = WebPartZone1.CloseVerb;
        break;
      case "export":
        theVerb = WebPartZone1.ExportVerb;
        break;
      case "delete":
        theVerb = WebPartZone1.DeleteVerb;
        break;
      case "minimize":
        theVerb = WebPartZone1.MinimizeVerb;
        break;
      case "restore":
        theVerb = WebPartZone1.RestoreVerb;
        break;
      default:
        theVerb = null;
        break;
    }

    if (item.Selected)
      theVerb.Enabled = true;
    else
      theVerb.Enabled = false;
  }
}

Protected Sub CheckBoxList1_SelectedItemIndexChanged(ByVal sender As [Object], ByVal e As EventArgs)
  Dim item As ListItem
  For Each item In CheckBoxList1.Items
    Dim theVerb As WebPartVerb
    Select Case item.Value
      Case "close"
        theVerb = WebPartZone1.CloseVerb
      Case "export"
        theVerb = WebPartZone1.ExportVerb
      Case "delete"
        theVerb = WebPartZone1.DeleteVerb
      Case "minimize"
        theVerb = WebPartZone1.MinimizeVerb
      Case "restore"
        theVerb = WebPartZone1.RestoreVerb
      Case Else
        theVerb = Nothing
    End Select

    If item.Selected Then
      theVerb.Enabled = True
    Else
      theVerb.Enabled = False
    End If
  Next item

End Sub

Der andere Teil des Codebeispiels ist die Webseite, die das benutzerdefinierte Steuerelement hostet und die Benutzeroberfläche (UI) enthält. Beachten Sie, dass das deklarative <DeleteVerb> Element in der Zone den spezifischen Text festlegt, der das Verb löschen im Dropdownmenü Verben für das WebPart Steuerelement darstellt.

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

Nachdem Sie die Seite in einem Browser geladen haben, wechseln Sie in den Kataloganzeigemodus, und fügen Sie das TextDisplayWebPart Steuerelement der Seite hinzu. Sie können die Kontrollkästchen verwenden, um das Löschverb im TextDisplayWebPart Steuerelement zu aktivieren und zu deaktivieren. Das Verb wird jedoch nur im Menü angezeigt, während sich die Seite im Katalog- oder Entwurfsanzeigemodus befindet. Wenn Sie im Menü auf das Verb WebPart löschen klicken, wird das Steuerelement endgültig gelöscht, und das gelöschte instance kann der Seite nicht wieder hinzugefügt werden. Sie können die Seite jedoch in den Kataloganzeigemodus zurückgeben und eine neue instance des TextDisplayWebPart Steuerelements hinzufügen.

Hinweise

Das von der DeleteVerb -Eigenschaft referenzierte Verb löschen wird im Dropdownmenü Verben in der Titelleiste jedes dynamischen WebPart Steuerelements in einer Zone angezeigt. Das Verb delete ist für statische Steuerelemente (Steuerelemente, die im Markup der Webseite deklariert sind) nicht verfügbar. Das Verb wird nur im Verbenmenü angezeigt, wenn sich die Seite in einem Anzeigemodus befindet, in dem Sie das Seitenlayout ändern können, z CatalogDisplayMode . B. oder DesignDisplayMode.

Durch das löschen eines Steuerelements wird die instance dieses Steuerelements dauerhaft von einer Seite entfernt. Im Gegensatz zu einem geschlossenen Steuerelement kann eine gelöschte instance eines Steuerelements nie wieder einer Seite hinzugefügt werden. Wenn ein Benutzer ein Steuerelement löscht und dann eine Seite in CatalogDisplayModewechselt, ist das gelöschte Steuerelement instance darin nicht verfügbar, wenn die CatalogZone Zone ein PageCatalogPart Steuerelement enthält. Der Benutzer kann eine neue instance eines Steuerelements hinzufügen, wenn das Steuerelement im Katalog verfügbar ist, das gelöschte instance jedoch endgültig entfernt wurde.

Gilt für:

Weitere Informationen