Udostępnij za pośrednictwem

WebPartZoneBase.DeleteVerb Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym usuwanie WebPart kontrolek w strefie.

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

Wartość właściwości

WebPartVerb

Element WebPartVerb , który umożliwia użytkownikom końcowym usuwanie WebPart kontrolek.

Atrybuty
PersistenceModeAttribute

Przykłady

Poniższy przykład kodu przedstawia użycie DeleteVerb właściwości w kontrolce WebPartZone . Aby przykład kodu działał, potrzebny jest cały kod z sekcji Przykład właściwości HelpVerb .

Poniższa część przykładu kodu pochodzi z klasy częściowej i zawiera kod, który przełącza się, czy czasownik usuwania jest włączony, czy wyłączony.

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

Drugą częścią przykładu kodu jest strona internetowa, która hostuje kontrolkę niestandardową i zawiera interfejs użytkownika. Zwróć uwagę, że element deklaratywny <DeleteVerb> w strefie ustawia określony tekst, który reprezentuje czasownik usuwania w menu rozwijanym czasowników dla kontrolki WebPart .

<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 załadowaniu strony w przeglądarce przełącz stronę do trybu wyświetlania wykazu i dodaj kontrolkę TextDisplayWebPart do strony. Za pomocą pól wyboru można włączyć i wyłączyć czasownik usuwania w TextDisplayWebPart kontrolce, ale czasownik jest wyświetlany w menu tylko wtedy, gdy strona jest w katalogu lub w trybie wyświetlania projektu. Po kliknięciu czasownika Usuń składnik Web Part w menu kontrolka zostanie trwale usunięta i nie można dodać usuniętego wystąpienia z powrotem do strony. Można jednak zwrócić stronę do trybu wyświetlania wykazu i dodać nowe wystąpienie kontrolki TextDisplayWebPart .

Uwagi

Czasownik usuwania przywoływalny przez DeleteVerb właściwość jest wyświetlany w menu rozwijanym czasowników na pasku tytułu każdej kontrolki dynamicznej WebPart w strefie. Czasownik usuwania nie jest dostępny w kontrolkach statycznych (kontrolki zadeklarowane w znacznikach strony sieci Web). Czasownik jest wyświetlany w menu czasowników tylko wtedy, gdy strona jest w trybie wyświetlania, który umożliwia zmianę układu strony, na przykład CatalogDisplayMode lub DesignDisplayMode.

Usunięcie kontrolki powoduje trwałe usunięcie wystąpienia tej kontrolki ze strony. W przeciwieństwie do zamkniętej kontrolki, usunięte wystąpienie kontrolki nigdy nie można dodać z powrotem do strony. Gdy użytkownik usunie kontrolkę, a następnie przełączy stronę do CatalogDisplayModeelementu , jeśli CatalogZone strefa zawiera kontrolkę PageCatalogPart , usunięte wystąpienie kontrolki nie jest w nim dostępne. Użytkownik może dodać nowe wystąpienie kontrolki, jeśli kontrolka jest dostępna w wykazie, ale usunięte wystąpienie zostało trwale usunięte.

Dotyczy

Zobacz też