WebPartZoneBase.DeleteVerb Eigenschap

Definitie

Hiermee haalt u een verwijzing op naar een WebPartVerb object waarmee eindgebruikers de WebPart besturingselementen in een zone kunnen verwijderen.

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

Waarde van eigenschap

Een WebPartVerb waarmee eindgebruikers besturingselementen kunnen verwijderen WebPart .

Kenmerken

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de DeleteVerb eigenschap op een WebPartZone besturingselement. Het codevoorbeeld werkt alleen als u alle code uit de sectie Voorbeeld van de HelpVerb eigenschap nodig hebt.

Het volgende deel van het codevoorbeeld is afkomstig uit de gedeeltelijke klasse en bevat de code waarmee wordt aangegeven of het verwijderwoord is ingeschakeld of uitgeschakeld.

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

Het andere deel van het codevoorbeeld is de webpagina waarop het aangepaste besturingselement wordt gehost en die de gebruikersinterface (UI) bevat. U ziet dat met het declaratieve <DeleteVerb> element in de zone de specifieke tekst wordt ingesteld die het verwijderwoord vertegenwoordigt in het vervolgkeuzemenu voor het WebPart besturingselement.

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

Nadat u de pagina in een browser hebt geladen, schakelt u de pagina over in de catalogusweergavemodus en voegt u het TextDisplayWebPart besturingselement toe aan de pagina. U kunt de selectievakjes gebruiken om het verwijderwoord op het TextDisplayWebPart besturingselement in te schakelen en uit te schakelen, maar het werkwoord wordt alleen weergegeven in het menu terwijl de pagina zich in de catalogus- of ontwerpweergavemodus bevindt. Als u in het menu op het webonderdeel Verwijderen klikt, wordt het besturingselement definitief verwijderd en kan het verwijderde exemplaar niet opnieuw aan de pagina worden toegevoegd. U kunt de pagina echter terugsturen naar de weergavemodus catalogus en een nieuw exemplaar van het TextDisplayWebPart besturingselement toevoegen.

Opmerkingen

Het verwijderwoord waarnaar door de DeleteVerb eigenschap wordt verwezen, wordt weergegeven in het vervolgkeuzemenu werkwoorden in de titelbalk van elk dynamisch WebPart besturingselement in een zone. Het verwijderwoord is niet beschikbaar voor statische besturingselementen (besturingselementen die zijn gedeclareerd in de markering van de webpagina). Het werkwoord wordt alleen weergegeven in het menu Werkwoorden wanneer de pagina zich in een weergavemodus bevindt waarmee u de pagina-indeling, zoals CatalogDisplayMode of DesignDisplayMode, kunt wijzigen.

Als u een besturingselement verwijdert, wordt het exemplaar van dat besturingselement definitief van een pagina verwijderd. In tegenstelling tot een gesloten besturingselement kan een verwijderd exemplaar van een besturingselement nooit meer worden toegevoegd aan een pagina. Wanneer een gebruiker een besturingselement verwijdert en vervolgens een pagina overschakelt naar CatalogDisplayMode, als de CatalogZone zone een PageCatalogPart besturingselement bevat, is het verwijderde besturingselementexemplaren er niet in beschikbaar. De gebruiker kan een nieuw exemplaar van een besturingselement toevoegen als het besturingselement beschikbaar is in de catalogus, maar het verwijderde exemplaar definitief is verwijderd.

Van toepassing op

Zie ook