WebPartChrome.GetWebPartVerbs(WebPart) Método

Definição

Obtém uma coleção de verbos que devem ser renderizados com controlo 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 controlo atualmente a ser renderizado.

Devoluções

A contendo WebPartVerbCollection todos os verbos que devem ser renderizados com webPart.

Exceções

webPart é null.

Exemplos

O seguinte exemplo de código demonstra a utilização do GetWebPartVerbs método. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo do WebPartChrome tópico de visão geral da aula.

A secção seguinte do exemplo de código demonstra como sobrescrever o GetWebPartVerbs método. O método sobreposto usa o método base para recuperar todos os verbos do webPart controlo, depois itera através da coleção de verbos, adicionando todos os verbos, exceto o verbo fechado, a um ArrayList objeto. Este conjunto reduzido de verbos é então atribuído a um novo WebPartVerbCollection, que é devolvido 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 carregar a página Web num navegador e clicar no menu de verbos (mostrado com uma seta para baixo na barra de título) de cada WebPart controlo, pode ver que o verbo de aproximação não é renderizado para nenhum controlo.

Observações

O GetWebPartVerbs método oferece aos programadores a oportunidade de sobrepor o método e excluir certos verbos de serem renderizados. Isto é 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 se quer verificar certos critérios para decidir se se deve traduzir um verbo. Em vez disso, este método é útil quando se sabe de antemão que se quer sempre excluir um determinado verbo. Por exemplo, se desenvolver uma classe personalizada WebPartChrome , pode decidir que quer sempre excluir o verbo close nos WebPart controlos, para que os utilizadores nunca possam fechar os controlos. Em vez de definir a AllowClose propriedade para false em todos os controlos, podes simplesmente sobrescrever o GetWebPartVerbs método e excluir verbos próximos de serem renderizados em qualquer WebPart controlo renderizado com o teu objeto personalizado WebPartChrome .

Aplica-se a

Ver também