WebPartChrome.GetWebPartVerbs(WebPart) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene un insieme di verbi di cui è necessario eseguire il rendering con un controllo 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

Parametri

webPart
WebPart

Controllo di cui viene attualmente eseguito il rendering.

Restituisce

WebPartVerbCollection

Un oggetto WebPartVerbCollection che contiene tutti i verbi di cui eseguire il rendering con il controllo webPart.

Eccezioni

ArgumentNullException

webPart è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del GetWebPartVerbs metodo . Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento panoramica della WebPartChrome classe.

Nella sezione seguente dell'esempio di codice viene illustrato come eseguire l'override del GetWebPartVerbs metodo. Il metodo sottoposto a override usa il metodo di base per recuperare tutti i verbi dal webPart controllo, quindi esegue l'iterazione tramite l'insieme verbo, aggiungendo tutti i verbi tranne il verbo vicino a un ArrayList oggetto. Questo set ridotto di verbi viene quindi assegnato a un nuovo WebPartVerbCollection, che viene restituito al chiamante.

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 si carica la pagina Web in un browser e si fa clic sul menu verbi (visualizzato con una freccia verso il basso nella barra del titolo) di ogni WebPart controllo, è possibile notare che il verbo di chiusura non viene eseguito per alcun controllo.

Commenti

Il GetWebPartVerbs metodo fornisce agli sviluppatori l'opportunità di eseguire l'override del metodo ed escludere determinati verbi dal rendering. È simile al FilterWebPartVerbs metodo, che può anche escludere i verbi dal rendering.

Tuttavia, il metodo non è destinato ai casi in cui si desidera controllare alcuni criteri per decidere se eseguire il GetWebPartVerbs rendering di un verbo. Questo metodo è invece utile quando si conosce in anticipo che si vuole escludere sempre un determinato verbo. Ad esempio, se si sviluppa una classe personalizzata WebPartChrome , è possibile decidere di escludere sempre il verbo di chiusura nei WebPart controlli, in modo che gli utenti non possano mai chiudere i controlli. Anziché impostare la proprietà su su tutti i controlli, è sufficiente eseguire l'override del AllowCloseGetWebPartVerbs metodo ed escludere i verbi di chiusura dal rendering su qualsiasi WebPart controllo sottoposto a rendering con l'oggetto personalizzatoWebPartChrome.false

Si applica a

Vedi anche