WebPartZoneBase.DeleteVerb Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům odstranit WebPart ovládací prvky v zóně.

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

Hodnota vlastnosti

WebPartVerb

A WebPartVerb , který umožňuje koncovým uživatelům odstranit WebPart ovládací prvky.

Atributy
PersistenceModeAttribute

Příklady

Následující příklad kódu ukazuje použití DeleteVerb vlastnosti WebPartZone ovládacího prvku. Aby příklad kódu fungoval, potřebujete veškerý kód z části HelpVerb Example vlastnosti .

Následující část příkladu kódu je z částečné třídy a obsahuje kód, který přepíná, zda je operace odstranění povolena nebo zakázána.

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

Druhou částí příkladu kódu je webová stránka, která je hostitelem vlastního ovládacího prvku a obsahuje uživatelské rozhraní (UI). Všimněte si, že deklarativní <DeleteVerb> prvek v zóně nastaví konkrétní text, který představuje příkaz odstranit v rozevírací nabídce sloves pro WebPart ovládací prvek.

<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>

Po načtení stránky v prohlížeči přepněte stránku do režimu zobrazení katalogu a přidejte TextDisplayWebPart na stránku ovládací prvek. Pomocí zaškrtávacích políček můžete u ovládacího prvku povolit nebo zakázat příkaz TextDisplayWebPart odstranit, ale příkaz se v nabídce zobrazí pouze v době, kdy je stránka v režimu zobrazení katalogu nebo návrhu. Pokud v nabídce kliknete na příkaz Odstranit webovou část , ovládací prvek se trvale odstraní a odstraněnou instanci nelze přidat zpět na stránku. Můžete ale stránku vrátit do režimu zobrazení katalogu a přidat novou instanci TextDisplayWebPart ovládacího prvku.

Poznámky

Příkaz odstranit, na který DeleteVerb vlastnost odkazuje, se zobrazí v rozevírací nabídce sloves v záhlaví každého dynamického WebPart ovládacího prvku v zóně. Příkaz odstranit není k dispozici u statických ovládacích prvků (ovládacích prvků deklarovaných ve značkách webové stránky). Příkaz se zobrazí v nabídce sloves pouze v případě, že je stránka v režimu zobrazení, který umožňuje změnit rozložení stránky, například CatalogDisplayMode nebo DesignDisplayMode.

Odstranění ovládacího prvku trvale odebere instanci tohoto ovládacího prvku ze stránky. Na rozdíl od zavřeného ovládacího prvku nelze odstraněnou instanci ovládacího prvku nikdy přidat zpět na stránku. Když uživatel odstraní ovládací prvek a potom přepne stránku na CatalogDisplayMode, pokud CatalogZone zóna obsahuje PageCatalogPart ovládací prvek, odstraněná instance ovládacího prvku v něm není k dispozici. Uživatel může přidat novou instanci ovládacího prvku, pokud je ovládací prvek k dispozici v katalogu, ale odstraněná instance byla trvale odebrána.

Platí pro

Viz také