WebPartChrome.GetWebPartVerbs(WebPart) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera kolekcję czasowników, które powinny być renderowane za pomocą kontrolki 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
Parametry
- webPart
- WebPart
Kontrolka jest obecnie renderowana.
Zwraca
Element WebPartVerbCollection zawierający wszystkie czasowniki, które powinny być renderowane za pomocą polecenia webPart
.
Wyjątki
webPart
to null
.
Przykłady
W poniższym przykładzie kodu pokazano użycie GetWebPartVerbs metody . Pełny kod wymagany do uruchomienia przykładu można znaleźć w sekcji Przykład tematu WebPartChrome przeglądu klasy.
W poniższej sekcji z przykładu kodu pokazano, jak zastąpić metodę GetWebPartVerbs . Metoda przesłonięć używa metody podstawowej do pobierania wszystkich czasowników z webPart
kontrolki, a następnie iteruje przez kolekcję czasowników, dodając wszystkie czasowniki z wyjątkiem czasownika bliskiego ArrayList do obiektu. Ten zredukowany zestaw czasowników jest następnie przypisywany do nowego WebPartVerbCollectionobiektu , który jest zwracany do obiektu wywołującego.
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
Jeśli załadujesz stronę sieci Web w przeglądarce i klikniesz menu czasowników (wyświetlane ze strzałką w dół na pasku tytułu) każdej WebPart kontrolki, zobaczysz, że czasownik zamykający nie jest renderowany dla żadnej kontrolki.
Uwagi
Metoda GetWebPartVerbs zapewnia deweloperom możliwość zastąpienia metody i wykluczenia niektórych czasowników z renderowania. Jest to podobne do FilterWebPartVerbs metody, która może również wykluczać czasowniki z renderowania.
Jednak metoda nie jest przeznaczona GetWebPartVerbs dla przypadków, w których chcesz sprawdzić niektóre kryteria, aby zdecydować, czy renderować czasownik. Zamiast tego ta metoda jest przydatna, gdy wiesz z wyprzedzeniem, że zawsze chcesz wykluczyć określone zlecenie. Jeśli na przykład utworzysz klasę niestandardową WebPartChrome , możesz zdecydować, że zawsze chcesz wykluczyć czasownik zamknięcia kontrolek WebPart , aby użytkownicy nigdy nie mogli zamknąć kontrolek. Zamiast ustawiać AllowClose właściwość na false
wszystkie kontrolki, możesz po prostu zastąpić GetWebPartVerbs metodę i wykluczyć czasowniki zamykane z renderowania na dowolnej WebPart kontrolce renderowanej z obiektem niestandardowym WebPartChrome .