WebPartZoneBase.DeleteVerb Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di eliminare i controlli WebPart di una zona.

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

Valore della proprietà

WebPartVerb

Oggetto WebPartVerb che consente agli utenti finali di eliminare i controlli WebPart.

Attributi
PersistenceModeAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della DeleteVerb proprietà in un WebPartZone controllo . Per il funzionamento dell'esempio di codice, è necessario tutto il codice della sezione Example della HelpVerb proprietà .

La parte seguente dell'esempio di codice proviene dalla classe parziale e contiene il codice che attiva o disattiva se il verbo di eliminazione è abilitato o disabilitato.

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

L'altra parte dell'esempio di codice è la pagina Web che ospita il controllo personalizzato e contiene l'interfaccia utente. Si noti che l'elemento dichiarativo <DeleteVerb> nella zona imposta il testo specifico che rappresenta il verbo di eliminazione nel menu a discesa verbi per il WebPart controllo .

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

Dopo aver caricato la pagina in un browser, passare alla modalità di visualizzazione del catalogo e aggiungere il TextDisplayWebPart controllo alla pagina. È possibile utilizzare le caselle di controllo per abilitare e disabilitare il verbo di eliminazione nel TextDisplayWebPart controllo , ma il verbo viene visualizzato solo mentre la pagina è in modalità di visualizzazione catalogo o progettazione. Se si fa clic sul verbo Elimina webPart dal menu, il controllo viene eliminato definitivamente e l'istanza eliminata non può essere aggiunta nuovamente alla pagina. È tuttavia possibile restituire la pagina alla modalità di visualizzazione del catalogo e aggiungere una nuova istanza del TextDisplayWebPart controllo .

Commenti

Il verbo delete a cui fa riferimento la DeleteVerb proprietà viene visualizzato nel menu a discesa verbi nella barra del titolo di ogni controllo dinamico WebPart in una zona. Il verbo di eliminazione non è disponibile nei controlli statici (controlli dichiarati nel markup della pagina Web). Il verbo viene visualizzato nel menu dei verbi solo quando la pagina è in modalità di visualizzazione che consente di modificare il layout di pagina, ad esempio CatalogDisplayMode o DesignDisplayMode.

L'eliminazione di un controllo rimuove definitivamente l'istanza di tale controllo da una pagina. A differenza di un controllo chiuso, un'istanza eliminata di un controllo non può mai essere aggiunta di nuovo a una pagina. Quando un utente elimina un controllo e quindi imposta una pagina in CatalogDisplayMode, se l'area CatalogZone contiene un PageCatalogPart controllo, l'istanza del controllo eliminato non è disponibile. L'utente può aggiungere una nuova istanza di un controllo, se il controllo è disponibile nel catalogo, ma l'istanza eliminata è stata rimossa definitivamente.

Si applica a

Vedi anche