共用方式為

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

範例

下列程式代碼範例示範如何存取 Verbs 自定義網頁元件控件的屬性。 本範例假設使用類別概觀的範例區段中所建立的WebPart自定義控件TextDisplayWebPart。

請注意，若要讓程式代碼範例能夠運作，您必須在 Web.config 檔案中新增設定，以啟用匯出網頁元件描述檔案。 請確定您在與此程式碼範例網頁相同的目錄中有一個 Web.config 檔案。 在區 <system.web> 段中，請確定有屬性 <webParts> 設定為 enableExporttrue的專案，如下列標記所示。

<webParts enableExport="true">

...

</webParts>

在瀏覽器中載入網頁。 當您按下 [ 顯示動詞計數 ] 按鈕時，它會存取 Verbs 屬性以取得控件的自定義動詞 TextDisplayWebPart 計數，並在標籤中顯示計數。 因為在此案例中未將自定義動詞新增至 控件，所以計數為零。

<%@ 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表示為按鈕、連結或功能表項。 根據預設，常見的網頁元件動詞動詞會出現在每個控件標題欄的 WebPart 下拉式動詞功能表上。 開啟、關閉、編輯和最小化控件的標準動詞，以及導出控件定義或載入說明檔的其他動詞。 這些動詞不會包含在集合中 Verbs ，因為集合只包含您在衍生類別中覆寫此屬性所建立和傳回的自定義動詞。

當您建立自定義動詞並將它們新增至集合時 Verbs ，就可以從 WebPart 控件以程序設計方式存取動詞。

給繼承者的注意事項

衍生類別可以覆寫 Verbs 屬性，以允許使用者將自定義 WebPartVerb 物件新增至控件的動詞集合 WebPart 。

適用於

另請參閱