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 自訂 Web 元件控制項的屬性。 此範例假設使用類別概觀的 Example 區段中所建立的 WebPart 自訂控制項 TextDisplayWebPart 。

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

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

適用於

另請參閱