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 элемента управления, а затем выполняет итерацию по коллекции глаголов, добавляя все команды, кроме команды close, в 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 класс, вы можете решить, что вы всегда хотите исключить команду close для WebPart элементов управления, чтобы пользователи никогда не могли закрывать элементы управления. Вместо того чтобы присвоить свойству AllowClose значение false для всех элементов управления, можно просто переопределить GetWebPartVerbs метод и исключить команды close из отображения в любом WebPart элементе управления, отображаемом с помощью пользовательского WebPartChrome объекта.

См. также раздел

• элементы управления веб-частей ASP.NET