WebPartZoneBase.DeleteVerb Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar en referens till ett WebPartVerb objekt som gör det möjligt för slutanvändare att ta bort WebPart kontrollerna i en zon.

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

Egenskapsvärde

WebPartVerb

En WebPartVerb som gör det möjligt för slutanvändare att ta bort WebPart kontroller.

Attribut
PersistenceModeAttribute

Exempel

I följande kodexempel visas hur egenskapen används på DeleteVerb en WebPartZone kontroll. För att kodexemplet ska fungera behöver du all kod från avsnittet Exempel i HelpVerb egenskapen.

Följande del av kodexemplet kommer från den partiella klassen och innehåller den kod som växlar om borttagningsverb är aktiverat eller inaktiverat.

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

Den andra delen av kodexemplet är webbsidan som är värd för den anpassade kontrollen och innehåller användargränssnittet (UI). Observera att det deklarativa <DeleteVerb> elementet i zonen anger den specifika text som representerar borttagningsverb i den nedrullningsbara verbmenyn för WebPart kontrollen.

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

När du har läst in sidan i en webbläsare växlar du sidan till katalogvisningsläge och lägger till TextDisplayWebPart kontrollen på sidan. Du kan använda kryssrutorna för att aktivera och inaktivera borttagningsverb på TextDisplayWebPart kontrollen, men verbet visas endast på menyn när sidan är i katalog- eller designvisningsläge. Om du klickar på verbet Ta bort webbdel på menyn tas kontrollen bort permanent och den borttagna instansen kan inte läggas tillbaka till sidan. Du kan dock återställa sidan till katalogvisningsläget och lägga till en ny instans av TextDisplayWebPart kontrollen.

Kommentarer

Borttagningsverb som refereras av DeleteVerb egenskapen visas i den nedrullningsbara verbmenyn i namnlisten för varje dynamisk WebPart kontroll i en zon. Borttagningsverb är inte tillgängligt för statiska kontroller (kontroller som deklareras i markering av webbsidan). Verbet visas endast i verbmenyn när sidan är i ett visningsläge som gör att du kan ändra sidlayouten, till exempel CatalogDisplayMode eller DesignDisplayMode.

Om du tar bort en kontroll permanent tas instansen av kontrollen bort från en sida. Till skillnad från en stängd kontroll kan en borttagen instans av en kontroll aldrig läggas tillbaka till en sida. När en användare tar bort en kontroll och sedan växlar en sida till CatalogDisplayMode, om CatalogZone zonen innehåller en PageCatalogPart kontroll, är den borttagna kontrollinstansen inte tillgänglig i den. Användaren kan lägga till en ny instans av en kontroll, om kontrollen är tillgänglig i katalogen, men den borttagna instansen har tagits bort permanent.

Gäller för

Se även