WebPartChrome.GetWebPartVerbs(WebPart) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 .