WebPartChrome.GetWebPartVerbs(WebPart) Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém uma coleção de verbos que devem ser renderizados com um controle de 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

Parâmetros

webPart

WebPart

O controle que está sendo renderizado no momento.

Retornos

WebPartVerbCollection

Uma WebPartVerbCollection que contém todos os verbos que devem ser renderizados com o webPart.

Exceções

ArgumentNullException

webPart é null.

Exemplos

O exemplo de código a seguir demonstra o uso do GetWebPartVerbs método . Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico visão geral da WebPartChrome classe.

A seção a seguir do exemplo de código demonstra como substituir o GetWebPartVerbs método . O método substituído usa o método base para recuperar todos os verbos do webPart controle e itera pela coleção de verbos, adicionando todos os verbos, exceto o verbo close a um ArrayList objeto . Esse conjunto reduzido de verbos é atribuído a um novo WebPartVerbCollection, que é retornado ao chamador.

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

Se você carregar a página da Web em um navegador e clicar no menu de verbos (mostrado com uma seta para baixo na barra de título) de cada WebPart controle, poderá ver que o verbo de fechamento não é renderizado para nenhum controle.

Comentários

O GetWebPartVerbs método fornece aos desenvolvedores a oportunidade de substituir o método e excluir determinados verbos de serem renderizados. Isso é semelhante ao FilterWebPartVerbs método , que também pode excluir verbos de serem renderizados.

No entanto, o GetWebPartVerbs método não se destina a casos em que você deseja verificar alguns critérios para decidir se deseja renderizar um verbo. Em vez disso, esse método é útil quando você sabe com antecedência que sempre deseja excluir um determinado verbo. Por exemplo, se você desenvolver uma classe personalizada WebPartChrome , poderá decidir que sempre deseja excluir o verbo close nos WebPart controles, para que os usuários nunca possam fechar os controles. Em vez de definir a AllowClose propriedade como false em todos os controles, você pode simplesmente substituir o GetWebPartVerbs método e excluir verbos de fechamento de serem renderizados em qualquer WebPart controle renderizado com seu objeto personalizado WebPartChrome .

Confira também

• Controles de Web Parts do ASP.NET