共用方式為

WebPartZoneBase.DeleteVerb 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得 WebPartVerb 物件的參考，這個物件可讓使用者刪除區域中的 WebPart 控制項。

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

屬性值

WebPartVerb

WebPartVerb，可讓使用者刪除 WebPart 控制項。

屬性
PersistenceModeAttribute

範例

下列程式代碼範例示範 DeleteVerb 在控件上使用 WebPartZone 屬性。 若要讓程式代碼範例能夠運作，您需要屬性的 Example 區段中 HelpVerb 的所有程式代碼。

程式代碼範例的下列部分來自部分類別，且包含會切換刪除動詞命令啟用或停用的程序代碼。

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

程式代碼範例的另一個部分是裝載自定義控件的網頁，其中包含使用者介面 (UI) 。 請注意，區域中的宣告式 <DeleteVerb> 元素會設定特定文字，代表控件之動詞命令下拉功能表 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>

在瀏覽器中載入頁面之後，請將頁面切換為目錄顯示模式，並將控件新增 TextDisplayWebPart 至頁面。 您可以使用複選框來啟用和停用控件上的 TextDisplayWebPart 刪除動詞，但動詞只有在頁面處於目錄或設計顯示模式時，才會出現在功能表上。 如果您單擊功能表上的 [ 刪除 WebPart ] 動詞，控件會永久刪除，而且無法將已刪除的實例新增回頁面。 不過，您可以將頁面傳回目錄顯示模式，並新增 控件的新實例 TextDisplayWebPart 。

備註

屬性所 DeleteVerb 參考的刪除動詞會出現在區域中每個動態 WebPart 控件標題列的動詞下拉功能表中。 刪除動詞不適用於靜態控件， (網頁標記中宣告的控件) 。 只有在頁面處於顯示模式時，動詞命令才會出現在動詞選單中，讓您變更頁面配置，例如 CatalogDisplayMode 或 DesignDisplayMode。

刪除控件會從頁面永久移除該控件的實例。 與關閉的控件不同，控件的已刪除實例永遠無法新增回頁面。 當使用者刪除控件，然後將頁面切換成 CatalogDisplayMode，如果 CatalogZone 區域包含 PageCatalogPart 控件，則已刪除的控件實例將無法在其中使用。 如果使用者在目錄中有控件可用，則可以新增控件的新實例，但已刪除的實例已永久移除。

適用於

另請參閱