次の方法で共有


WebPart.Verbs プロパティ

定義

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

プロパティ値

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

実装

属性

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

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

<webParts enableExport="true">

...

</webParts>

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

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

注意 (継承者)

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

適用対象

こちらもご覧ください