WebPartChrome.GetWebPartVerbs(WebPart) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.WebPartVerbCollectionProtected Overridable Function GetWebPartVerbs (webPart As WebPart) As WebPartVerbCollectionParâmetros
- webPart
- WebPart
O controle que está sendo renderizado no momento.
Retornos
Uma WebPartVerbCollection que contém todos os verbos que devem ser renderizados com o webPart.
Exceções
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 .
