WebPartChrome.GetWebPartVerbs(WebPart) Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar en samling verb som ska renderas med en WebPart kontroll.

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

Parametrar

webPart
WebPart

Kontrollen återges för närvarande.

Returer

WebPartVerbCollection

En WebPartVerbCollection som innehåller alla verb som ska återges med webPart.

Undantag

ArgumentNullException

webPart är null.

Exempel

I följande kodexempel visas hur metoden används GetWebPartVerbs . Fullständig kod som krävs för att köra exemplet finns i avsnittet Exempel i WebPartChrome avsnittet klassöversikt.

Följande avsnitt i kodexemplet visar hur du åsidosätter GetWebPartVerbs metoden. Den åsidosatta metoden använder basmetoden för att hämta alla verb från webPart kontrollen och itererar sedan genom verbsamlingen och lägger till alla verb utom det nära verbet till ett ArrayList objekt. Den här reducerade uppsättningen verb tilldelas sedan till en ny WebPartVerbCollection, som returneras till anroparen.

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

Om du läser in webbsidan i en webbläsare och klickar på verbmenyn (visas med en nedåtpil i namnlisten) för varje WebPart kontroll kan du se att det nära verbet inte återges för någon kontroll.

Kommentarer

Metoden GetWebPartVerbs ger utvecklare möjlighet att åsidosätta metoden och undanta vissa verb från att renderas. Detta liknar FilterWebPartVerbs metoden, som också kan undanta verb från att renderas.

Metoden är dock GetWebPartVerbs inte avsedd för fall där du vill kontrollera vissa kriterier för att avgöra om ett verb ska återges. I stället är den här metoden användbar när du i förväg vet att du alltid vill exkludera ett visst verb. Om du till exempel utvecklar en anpassad WebPartChrome klass kan du bestämma att du alltid vill exkludera det nära verbet för WebPart kontroller, så att användarna aldrig kan stänga kontrollerna. I stället för att ställa in AllowClose egenskapen på på alla kontroller kan du helt enkelt åsidosätta false metoden och utesluta att nära verb återges på alla GetWebPartVerbs kontroller som återges med ditt anpassade WebPartWebPartChrome objekt.

Gäller för

Se även