WebPartChrome.GetWebPartVerbs(WebPart) 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

取得應使用 WebPart 控制項呈現的動詞命令集合。

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ GetWebPartVerbs(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection GetWebPartVerbs (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection
override this.GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection

Protected Overridable Function GetWebPartVerbs (webPart As WebPart) As WebPartVerbCollection

參數

webPart

WebPart

目前正在呈現的控制項。

傳回

WebPartVerbCollection

WebPartVerbCollection，包含應使用 webPart 呈現的所有動詞命令。

例外狀況

ArgumentNullException

webPart 為 null。

範例

下列程式代碼範例示範如何使用 GetWebPartVerbs 方法。 如需執行範例所需的完整程式碼，請參閱類別概觀主題的 WebPartChrome 一節。

程式代碼範例的下一節示範如何覆寫 GetWebPartVerbs 方法。 覆寫的 方法會使用基底方法從 webPart 控件擷取所有動詞，然後逐一查看動詞集合，並新增物件關閉動詞以外的所有動 ArrayList 詞。 這個減少的動詞集接著會指派給傳回給呼叫端的新 WebPartVerbCollection。

protected override WebPartVerbCollection GetWebPartVerbs(WebPart webPart)
{
  ArrayList verbSet = new ArrayList();
  foreach (WebPartVerb verb in base.GetWebPartVerbs(webPart))
  {
    if (verb.Text != "Close")
      verbSet.Add(verb);
  }
  WebPartVerbCollection reducedVerbSet = 
    new WebPartVerbCollection(verbSet);
  return reducedVerbSet;
}

Protected Overrides Function GetWebPartVerbs _
  (ByVal webPart As WebPart) As WebPartVerbCollection

  Dim verbSet As New ArrayList()
  Dim verb As WebPartVerb
  For Each verb In MyBase.GetWebPartVerbs(webPart)
    If verb.Text <> "Close" Then
      verbSet.Add(verb)
    End If
  Next verb

  Dim reducedVerbSet As WebPartVerbCollection = _
    New WebPartVerbCollection(verbSet)

  Return reducedVerbSet
End Function

如果您在瀏覽器中載入網頁，然後按下動詞功能表， (顯示每個控件標題列中的向下箭號) WebPart ，您可以看到關閉動詞不會轉譯給任何控件。

備註

方法 GetWebPartVerbs 可讓開發人員有機會覆寫 方法，並排除正在轉譯的特定動詞。 這類似於 FilterWebPartVerbs 方法，它也可以排除動詞的轉譯。

不過， GetWebPartVerbs 此方法不適用於您想要檢查某些準則以決定是否要轉譯動詞的案例。 相反地，當您事先知道一律想要排除特定動詞時，這個方法會很有用。 例如，如果您開發自定義 WebPartChrome 類別，您可能會決定一律要排除控件上的 WebPart 關閉動詞，讓使用者永遠無法關閉控件。 除了在所有控件上將 屬性設定AllowClose為 false ，您也可以直接覆寫 GetWebPartVerbs 方法，並排除使用自定義WebPartChrome物件轉譯的任何WebPart控件上呈現關閉動詞。

另請參閱

• ASP.NET 網頁元件控制件