WebPartZoneBase.DeleteVerb プロパティ

定義

エンド ユーザーがゾーン内の 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 コントロールを削除できるようにする WebPart

属性

次のコード例では、コントロールで プロパティを 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

コード例のもう 1 つの部分は、カスタム コントロールをホストし、ユーザー インターフェイス (UI) を含む Web ページです。 ゾーンの宣言型 <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 コントロールのタイトル バーの動詞ドロップダウン メニューに表示されます。 delete 動詞は、静的コントロール (Web ページのマークアップで宣言されたコントロール) では使用できません。 動詞は、 や DesignDisplayModeなどのCatalogDisplayModeページ レイアウトを変更できる表示モードの場合にのみ、動詞メニューに表示されます。

コントロールを削除すると、そのコントロールのインスタンスがページから完全に削除されます。 閉じたコントロールとは異なり、削除されたコントロールのインスタンスをページに追加し直すことはできません。 ユーザーがコントロールを削除し、ページを に切り替えると、ゾーンにCatalogDisplayModeコントロールが含まれているPageCatalogPart場合CatalogZone、削除されたコントロール インスタンスは使用できません。 ユーザーは、カタログでコントロールを使用できるが、削除されたインスタンスが完全に削除されている場合は、コントロールの新しいインスタンスを追加できます。

適用対象

こちらもご覧ください