WebPartChrome.GetWebPartVerbs(WebPart) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft eine Auflistung von Verben ab, die mit einem WebPart-Steuerelement gerendert werden sollen.

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

Parameter

webPart
WebPart

Das Steuerelement, das gerade gerendert wird.

Gibt zurück

WebPartVerbCollection

Eine WebPartVerbCollection-Auflistung, die alle Verben enthält, die mit dem webPart-Steuerelement gerendert werden sollen.

Ausnahmen

ArgumentNullException

webPart ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetWebPartVerbs -Methode veranschaulicht. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des WebPartChrome Themas Klassenübersicht.

Im folgenden Abschnitt des Codebeispiels wird veranschaulicht, wie die GetWebPartVerbs -Methode überschrieben wird. Die überschriebene Methode verwendet die Basismethode, um alle Verben aus dem webPart -Steuerelement abzurufen, durchlaufen dann die Verbauflistung und fügt alle Verben mit Ausnahme des schließenden Verbs zu einem ArrayList Objekt hinzu. Dieser reduzierte Satz von Verben wird dann einem neuen WebPartVerbCollectionzugewiesen, der an den Aufrufer zurückgegeben wird.

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

Wenn Sie die Webseite in einem Browser laden und auf das Verbenmenü (mit einem Pfeil nach unten in der Titelleiste) jedes WebPart Steuerelements klicken, können Sie sehen, dass das Schließen-Verb für kein Steuerelement gerendert wird.

Hinweise

Die GetWebPartVerbs -Methode bietet Entwicklern die Möglichkeit, die Methode zu überschreiben und bestimmte Verben vom Rendern auszuschließen. Dies ähnelt der FilterWebPartVerbs -Methode, die auch Verben vom Rendern ausschließen kann.

Die -Methode ist jedoch nicht für Fälle gedacht, GetWebPartVerbs in denen Sie einige Kriterien überprüfen möchten, um zu entscheiden, ob ein Verb gerendert werden soll. Stattdessen ist diese Methode nützlich, wenn Sie im Voraus wissen, dass Sie ein bestimmtes Verb immer ausschließen möchten. Wenn Sie beispielsweise eine benutzerdefinierte WebPartChrome Klasse entwickeln, können Sie entscheiden, dass Sie das Schließen-Verb WebPart für Steuerelemente immer ausschließen möchten, sodass Benutzer die Steuerelemente nie schließen können. Anstatt die AllowClose -Eigenschaft für alle Steuerelemente auf false festzulegen, können Sie einfach die GetWebPartVerbs -Methode überschreiben und schließende Verben vom Rendern für jedes WebPart Steuerelement ausschließen, das mit Ihrem benutzerdefinierten WebPartChrome Objekt gerendert wird.

Gilt für:

Weitere Informationen