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 Web 組件控制項