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

包含应使用 webPart 呈现的所有谓词的 WebPartVerbCollection。

例外

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 close 谓词，以便用户永远无法关闭控件。 无需在所有控件上将 属性设置为 AllowClosefalse ，只需重写 GetWebPartVerbs 方法，并排除在随自定义WebPartChrome对象呈现的任何WebPart控件上呈现的关闭谓词。

另请参阅

• ASP.NET Web 部件控件