Sdílet prostřednictvím

WebPartZoneBase.DeleteVerb Vlastnost

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á koncovým uživatelům umožňuje 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 Příklad vlastnosti.

Následující část příkladu kódu pochází z částečné třídy a obsahuje kód, který přepíná, jestli je příkaz delete povolený nebo zakázaný.

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

Druhá část příkladu kódu je webová stránka, která je hostitelem vlastního ovládacího prvku a obsahuje uživatelské rozhraní. Všimněte si, že deklarativní <DeleteVerb> prvek v zóně nastaví konkrétní text, který představuje příkaz delete v rozevírací nabídce příkazů 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 ovládací prvek na stránku. Zaškrtávací políčka můžete použít k povolení a zakázání příkazu odstranění v ovládacím TextDisplayWebPart prvku, ale příkaz se zobrazí v nabídce 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ěná instance se nedá přidat zpět na stránku. Můžete ale vrátit stránku do režimu zobrazení katalogu a přidat novou instanci TextDisplayWebPart ovládacího prvku.

Poznámky

Příkaz delete odkazovaný vlastností DeleteVerb se zobrazí v rozevírací nabídce příkazů 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í prvky deklarované v kódu 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 do CatalogDisplayMode, pokud CatalogZone zóna obsahuje PageCatalogPart ovládací prvek, odstraněná instance ovládacího prvku není v něm k dispozici. Uživatel může přidat novou instanci ovládacího prvku, pokud je ovládací prvek dostupný v katalogu, ale odstraněná instance byla trvale odebrána.

Platí pro

Viz také