次の方法で共有


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

プロパティ値

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

実装

属性

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

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

<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 追加できるようにします。

適用対象

こちらもご覧ください