語言

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 A 包含與WebPartVerb控制項相關的自訂WebPart物件。 預設值為 Empty。

實作

Verbs
屬性
BrowsableAttribute

範例

以下程式碼範例示範如何存取 Verbs 自訂 Web Parts 控制項的屬性。 本範例假設使用類別總覽範例區TextDisplayWebPart段中建立的自訂控制項 WebPart， ，

請注意，若要讓程式碼範例正常運作，您必須在 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 ，並提供使用者可對 WebPart 控制項執行的使用者介面（UI）動作。 通常動詞會在使用者介面中以按鈕、連結或選單項目的形式呈現。 預設情況下，常見的 Web Parts 動詞會出現在每個 WebPart 控制項標題欄的下拉動詞選單中。 有標準的動詞用於開啟、關閉、編輯和最小化控制項，也有其他用於匯出控制項定義或載入說明檔案的動詞。 這些動詞不包含在 Verbs 集合中，因為集合只包含你建立並透過覆寫此屬性在衍生類別中回傳的自訂動詞。

當你建立自訂動詞並加入 Verbs 集合時，就可以從 WebPart 控制項以程式方式存取這些動詞。

給繼承者的注意事項

衍生類別可以覆寫該 Verbs 屬性，讓使用者能將自訂 WebPartVerb 物件加入動詞集合以建立 WebPart 控制項。

適用於

另請參閱