WebPart.Verbs プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

WebPart コントロールに関連付けられたカスタム動詞のコレクションを取得します。

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ Verbs { System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection Verbs { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Verbs : System.Web.UI.WebControls.WebParts.WebPartVerbCollection
Public Overridable ReadOnly Property Verbs As WebPartVerbCollection

プロパティ値

WebPartVerbCollection

WebPartVerbCollection コントロールに関連付けられたカスタム WebPartVerb のオブジェクトを格納する WebPart。 既定値は Empty です。

実装

Verbs
属性
BrowsableAttribute

例

次のコード例では、カスタム Web パーツ コントロールの Verbs プロパティにアクセスする方法を示します。 この例では、 TextDisplayWebPartクラスの概要の「例」セクションで作成されたカスタム コントロール の使用を WebPart 前提としています。

コード例を機能させるには、Web パーツ記述ファイルのエクスポートを有効にするには、Web.config ファイルに設定を追加する必要があります。 このコード例の Web ページと同じディレクトリにWeb.config ファイルがあることを確認します。 セクション内に <system.web> 、次の <webParts> マークアップのように 属性 enableExport が に true設定された要素があることを確認します。

<webParts enableExport="true">

...

</webParts>

ブラウザーに Web ページを読み込みます。 [ 動詞カウントの表示 ] ボタンをクリックすると、 プロパティにアクセス Verbs してコントロールのカスタム動詞の数を TextDisplayWebPart 取得し、その数をラベルに表示します。 この場合、コントロールにカスタム動詞が追加されていないため、カウントは 0 です。

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

void  button1_Click(object sender, EventArgs e)
{
  label1.Text = "Verb count = " + 
    textwebpart.Verbs.Count.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      OnClick="button1_Click" 
      Text="Display Verb Count" 
      />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    label1.Text = "Verb Count = " & _
      textwebpart.Verbs.Count.ToString()
    
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            ExportMode="all" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      Text="Display Verb Count" OnClick="button1_Click" />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

注釈

動詞は クラスから WebPartVerb 派生し、ユーザーがコントロールに対して実行できるユーザー インターフェイス (UI) アクションを WebPart 提供します。 通常、動詞は UI でボタン、リンク、またはメニュー項目として表されます。 既定では、一般的な Web パーツ動詞は、各 WebPart コントロールのタイトル バーのドロップダウン動詞メニューに表示されます。 コントロールを開いたり、閉じたり、編集したり、最小化したりするための標準的な動詞や、コントロールの定義をエクスポートしたり、ヘルプ ファイルを読み込んだりするためのその他の動詞があります。 コレクションには、派生クラスでこのプロパティを Verbs オーバーライドして作成して返すカスタム動詞のみが含まれているため、これらの動詞はコレクションに含まれません。

カスタム動詞を作成してコレクションに Verbs 追加すると、コントロールから WebPart プログラムで動詞にアクセスできます。

注意 (継承者)

派生クラスは、 プロパティを Verbs オーバーライドして、ユーザーがコントロールの動詞コレクションにカスタム WebPartVerb オブジェクトを WebPart 追加できるようにします。

適用対象

こちらもご覧ください