WebPartZoneBase.DeleteVerb Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais eliminar os WebPart controlos numa 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

Valor de Propriedade

WebPartVerb

A que permite aos WebPartVerb utilizadores finais eliminar WebPart controlos.

Atributos
PersistenceModeAttribute

Exemplos

O exemplo de código seguinte demonstra a utilização da DeleteVerb propriedade num WebPartZone controlo. Para que o exemplo de código funcione, precisas de todo o código da secção de Exemplo da HelpVerb propriedade.

A parte seguinte do exemplo de código é da classe parcial e contém o código que alterna se o verbo delete está ativado ou desativado.

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

A outra parte do exemplo do código é a página Web que hospeda o controlo personalizado e contém a interface do utilizador (UI). Note que o elemento declarativo <DeleteVerb> na zona define o texto específico que representa o verbo delete no menu suspenso de verbos para o WebPart controlo.

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

Depois de carregar a página num navegador, mude a página para o modo de exibição de catálogo e adicione o TextDisplayWebPart controlo à página. Pode usar as caixas de seleção para ativar e desativar o verbo delete no TextDisplayWebPart controlo, mas o verbo aparece no menu apenas enquanto a página está em modo de catálogo ou design display. Se clicar no verbo Eliminar WebPart no menu, o controlo é eliminado permanentemente e a instância eliminada não pode ser adicionada novamente à página. No entanto, podes voltar a colocar a página no modo de visualização de catálogo e adicionar uma nova instância do TextDisplayWebPart controlo.

Observações

O verbo delete referenciado pela DeleteVerb propriedade aparece no menu suspenso verbos na barra de título de cada controlo dinâmico WebPart numa zona. O verbo delete não está disponível nos controlos estáticos (controlos declarados na marcação da página Web). O verbo aparece no menu de verbos apenas quando a página está num modo de exibição que permite alterar o layout da página, como CatalogDisplayMode ou DesignDisplayMode.

Eliminar um controlo remove permanentemente a instância desse controlo de uma página. Ao contrário de um controlo fechado, uma instância eliminada de um controlo nunca pode ser adicionada novamente a uma página. Quando um utilizador elimina um controlo e depois muda uma página para CatalogDisplayMode, se a CatalogZone zona contiver um PageCatalogPart controlo, a instância de controlo eliminada não está disponível nela. O utilizador pode adicionar uma nova instância de um controlo, se o controlo estiver disponível no catálogo, mas a instância eliminada tiver sido removida permanentemente.

Aplica-se a

Ver também