WebPartChrome.GetWebPartVerbs(WebPart) Méthode

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient une collection de verbes qui doivent être restitués avec un contrôle 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

Paramètres

webPart

WebPart

Contrôle actuellement en cours de présentation.

Retours

WebPartVerbCollection

WebPartVerbCollection contenant tous les verbes qui doivent être restitués avec webPart.

Exceptions

ArgumentNullException

webPart a la valeur null.

Exemples

L’exemple de code suivant illustre l’utilisation de la GetWebPartVerbs méthode . Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la rubrique Vue d’ensemble de la WebPartChrome classe.

La section suivante de l’exemple de code montre comment remplacer la GetWebPartVerbs méthode. La méthode remplacée utilise la méthode de base pour récupérer tous les verbes du webPart contrôle, puis itère dans la collection de verbes, en ajoutant tous les verbes à l’exception du verbe proche à un ArrayList objet. Cet ensemble réduit de verbes est ensuite affecté à un nouveau WebPartVerbCollection, qui est retourné à l’appelant.

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 vous chargez la page web dans un navigateur et cliquez sur le menu verbes (avec une flèche vers le bas dans la barre de titre) de chaque WebPart contrôle, vous pouvez voir que le verbe de fermeture n’est rendu pour aucun contrôle.

Remarques

La GetWebPartVerbs méthode offre aux développeurs la possibilité de remplacer la méthode et d’exclure certains verbes du rendu. Cette méthode est similaire à la FilterWebPartVerbs méthode, qui peut également exclure le rendu des verbes.

Toutefois, la GetWebPartVerbs méthode n’est pas destinée aux cas où vous souhaitez vérifier certains critères pour décider s’il faut restituer un verbe. Au lieu de cela, cette méthode est utile lorsque vous savez à l’avance que vous souhaitez toujours exclure un certain verbe. Par exemple, si vous développez une classe personnalisée WebPartChrome , vous pouvez décider que vous souhaitez toujours exclure le verbe fermer sur WebPart les contrôles, afin que les utilisateurs ne puissent jamais fermer les contrôles. Au lieu de définir la AllowClose propriété false sur sur tous les contrôles, vous pouvez simplement remplacer la GetWebPartVerbs méthode et exclure le rendu des verbes fermés sur n’importe quel WebPart contrôle rendu avec votre objet personnalisé WebPartChrome .

Voir aussi

• contrôles de composants WebPart ASP.NET