WebPartChrome.GetWebPartVerbs(WebPart) Método
Definição
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.The control currently being rendered.
Retornos
Uma WebPartVerbCollection que contém todos os verbos que devem ser renderizados com o webPart.A WebPartVerbCollection containing all the verbs that should be rendered with webPart.
Exceções
webPart é null.webPart is null.
Exemplos
O exemplo de código a seguir demonstra o uso do GetWebPartVerbs método.The following code example demonstrates use of the GetWebPartVerbs method. Para obter o código completo necessário para executar o exemplo, consulte a seção de exemplo do WebPartChrome tópico Visão geral da classe.For the full code required to run the example, see the Example section of the WebPartChrome class overview topic.
A seção a seguir do exemplo de código demonstra como substituir o GetWebPartVerbs método.The following section from the code example demonstrates how to override the GetWebPartVerbs method. O método substituído usa o método base para recuperar todos os verbos do webPart controle e, em seguida, itera pela coleção de verbos, adicionando todos os verbos, exceto o verbo Close, a um ArrayList objeto.The overridden method uses the base method to retrieve all verbs from the webPart control, then iterates through the verb collection, adding all verbs except the close verb to an ArrayList object. Esse conjunto reduzido de verbos é então atribuído a um novo WebPartVerbCollection , que é retornado para o chamador.This reduced set of verbs is then assigned to a new WebPartVerbCollection, which is returned to the caller.
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 Close não é renderizado para nenhum controle.If you load the Web page in a browser and click the verbs menu (shown with a downward arrow in the title bar) of each WebPart control, you can see that the close verb is not rendered for any control.
Comentários
O GetWebPartVerbs método fornece aos desenvolvedores uma oportunidade de substituir o método e excluir determinados verbos de serem renderizados.The GetWebPartVerbs method provides developers with an opportunity to override the method and exclude certain verbs from being rendered. Isso é semelhante ao FilterWebPartVerbs método, que também pode excluir verbos de serem renderizados.This is similar to the FilterWebPartVerbs method, which also can exclude verbs from being rendered.
No entanto, o GetWebPartVerbs método não é destinado a casos em que você deseja verificar alguns critérios para decidir se deve renderizar um verbo.However, the GetWebPartVerbs method is not meant for cases where you want to check some criteria to decide whether to render a verb. Em vez disso, esse método é útil quando você sabe com antecedência que sempre deseja excluir um determinado verbo.Instead, this method is useful when you know in advance that you always want to exclude a certain verb. Por exemplo, se você desenvolver uma WebPartChrome classe personalizada, poderá decidir que sempre deseja excluir o verbo de fechamento em WebPart controles, para que os usuários nunca possam fechar os controles.For example, if you develop a custom WebPartChrome class, you might decide that you always want to exclude the close verb on WebPart controls, so that users can never close the controls. Em vez de definir a AllowClose propriedade como false em todos os controles, você pode simplesmente substituir o GetWebPartVerbs método e excluir os verbos de fechamento de serem renderizados em qualquer WebPart controle renderizado com o objeto personalizado WebPartChrome .Rather than setting the AllowClose property to false on all the controls, you can simply override the GetWebPartVerbs method and exclude close verbs from being rendered on any WebPart control rendered with your custom WebPartChrome object.