WebPartChrome.GetWebPartVerbs(WebPart) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene una colección de verbos que se deben representar con un control 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
Control que se representa actualmente.
Devoluciones
Una colección WebPartVerbCollection que contiene todos los verbos que se deben representar con webPart
.
Excepciones
webPart
es null
.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del GetWebPartVerbs método . Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la WebPartChrome clase.
En la sección siguiente del ejemplo de código se muestra cómo invalidar el GetWebPartVerbs método . El método invalidado usa el método base para recuperar todos los verbos del webPart
control y, a continuación, recorre en iteración la colección de verbos, agregando todos los verbos excepto el verbo close a un ArrayList objeto. A continuación, este conjunto reducido de verbos se asigna a un nuevo WebPartVerbCollection, que se devuelve al autor de la llamada.
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
Si carga la página web en un explorador y hace clic en el menú verbos (que se muestra con una flecha hacia abajo en la barra de título) de cada WebPart control, puede ver que el verbo close no se representa para ningún control.
Comentarios
El GetWebPartVerbs método proporciona a los desarrolladores la oportunidad de invalidar el método y excluir determinados verbos de representarse. Esto es similar al FilterWebPartVerbs método , que también puede excluir verbos de representarse.
Sin embargo, el GetWebPartVerbs método no está pensado para los casos en los que desea comprobar algunos criterios para decidir si se va a representar un verbo. En su lugar, este método es útil cuando sabe de antemano que siempre desea excluir un verbo determinado. Por ejemplo, si desarrolla una clase personalizada WebPartChrome , puede decidir que siempre desea excluir el verbo close en WebPart los controles para que los usuarios nunca puedan cerrar los controles. En lugar de establecer la AllowClose propiedad false
en en todos los controles, simplemente puede invalidar el GetWebPartVerbs método y excluir que los verbos close se representen en cualquier WebPart control representado con el objeto personalizado WebPartChrome .