WebPartZoneBase.DeleteVerb プロパティ

.NET Framework クラス ライブラリ リファレンス

WebPartZoneBase.DeleteVerb プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

エンド ユーザーがゾーン内の WebPart コントロールを削除できるようにする WebPartVerb オブジェクトへの参照を取得します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property DeleteVerb As WebPartVerb

Visual Basic (使用法)

Dim instance As WebPartZoneBase
Dim value As WebPartVerb

value = instance.DeleteVerb

C#

public virtual WebPartVerb DeleteVerb { get;
 }

C++

public:
virtual property WebPartVerb^ DeleteVerb {
    WebPartVerb^ get ();
}

J#

/** @property */
public WebPartVerb get_DeleteVerb ()

JScript

public function get DeleteVerb
 () : WebPartVerb

プロパティ値
エンド ユーザーが WebPart コントロールを削除できるようにする WebPartVerb。

解説

DeleteVerb プロパティによって参照される delete 動詞は、ゾーン内の個々の動的 WebPart コントロールのタイトル バーにある動詞ドロップダウン メニューに表示されます。delete 動詞は、スタティック コントロール (Web ページのマークアップで宣言されているコントロール) では利用できません。動詞メニューに動詞が表示されるのは、ページが、CatalogDisplayMode または DesignDisplayMode などの、ページ レイアウトを変更できる表示モードの場合だけです。

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

使用例

WebPartZone コントロールで DeleteVerb プロパティを使用するコード例を次に示します。コード例が正常に処理されるためには、HelpVerb プロパティの例のすべてのコードが必要です。

コード例の次の部分は、部分クラスのコードで、delete 動詞が有効か無効かを切り替えるコードを含んでいます。

Visual Basic

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

C#

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

コード例のその他の部分は、カスタム コントロールをホストし、ユーザー インターフェイス (UI) を含む Web ページです。ゾーン内の宣言 <DeleteVerb> 要素で、WebPart コントロールの動詞ドロップダウン メニューの delete 動詞を表す特定のテキストが設定されています。

Visual Basic

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

C#

<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 コントロールの delete 動詞を有効または無効にできますが、この動詞がメニューに表示されるのは、ページがカタログ表示モードまたはデザイン表示モードの場合だけです。メニューの [Delete WebPart] 動詞をクリックした場合、コントロールは完全に削除され、削除されたインスタンスをページに戻すことはできません。ただし、ページをカタログ表示モードに戻し、TextDisplayWebPart コントロールの新しいインスタンスを追加することはできます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartZoneBase クラス
WebPartZoneBase メンバ
System.Web.UI.WebControls.WebParts 名前空間
DeleteWebPart
その他の技術情報
ASP.NET Web パーツ ページ