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

另请参阅

• ASP.NET Web 部件控件