WebPartZoneBase.CloseVerb Właściwość
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 odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym zamykanie WebPart kontrolek w strefie.
public:
virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property CloseVerb As WebPartVerb
Wartość właściwości
Element WebPartVerb , który umożliwia użytkownikom końcowym zamykanie WebPart kontrolek.
- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano użycie CloseVerb właściwości w kontrolce WebPartZone . Aby przykładowy kod działał, potrzebny jest cały kod z sekcji HelpVerb Przykład właściwości .
Poniższa część przykładu kodu pochodzi z klasy częściowej i zawiera kod, który przełącza, czy czasownik pomocy jest włączony, czy wyłączony.
protected void CheckBoxList1_SelectedItemIndexChanged(Object sender, EventArgs e)
{
foreach (ListItem item in CheckBoxList1.Items)
{
WebPartVerb theVerb;
switch (item.Value)
{
case "close":
theVerb = WebPartZone1.CloseVerb;
break;
case "export":
theVerb = WebPartZone1.ExportVerb;
break;
case "delete":
theVerb = WebPartZone1.DeleteVerb;
break;
case "minimize":
theVerb = WebPartZone1.MinimizeVerb;
break;
case "restore":
theVerb = WebPartZone1.RestoreVerb;
break;
default:
theVerb = null;
break;
}
if (item.Selected)
theVerb.Enabled = true;
else
theVerb.Enabled = false;
}
}
Protected Sub CheckBoxList1_SelectedItemIndexChanged(ByVal sender As [Object], ByVal e As EventArgs)
Dim item As ListItem
For Each item In CheckBoxList1.Items
Dim theVerb As WebPartVerb
Select Case item.Value
Case "close"
theVerb = WebPartZone1.CloseVerb
Case "export"
theVerb = WebPartZone1.ExportVerb
Case "delete"
theVerb = WebPartZone1.DeleteVerb
Case "minimize"
theVerb = WebPartZone1.MinimizeVerb
Case "restore"
theVerb = WebPartZone1.RestoreVerb
Case Else
theVerb = Nothing
End Select
If item.Selected Then
theVerb.Enabled = True
Else
theVerb.Enabled = False
End If
Next item
End Sub
Drugą częścią przykładu kodu jest strona internetowa, która hostuje kontrolkę niestandardową i zawiera interfejs użytkownika. Zwróć uwagę, że element deklaratywny <CloseVerb>
w strefie ustawia określony tekst, który reprezentuje czasownik bliski w menu czasowników dla kontrolki WebPart .
<asp:WebPartZone ID="WebPartZone1" Runat="server">
<CloseVerb Text="Close WebPart" />
<HelpVerb Text="View Help" />
<ExportVerb Text="Export WebPart Definition" />
<DeleteVerb Text ="Delete WebPart" />
<MinimizeVerb Description="Minimize the control" />
<RestoreVerb Description="Restore the control" />
<ZoneTemplate>
</ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone ID="WebPartZone1" Runat="server">
<CloseVerb Text="Close WebPart" />
<HelpVerb Text="View Help" />
<ExportVerb Text="Export WebPart Definition" />
<DeleteVerb Text ="Delete WebPart" />
<MinimizeVerb Description="Minimize the control" />
<RestoreVerb Description="Restore the control" />
<ZoneTemplate>
</ZoneTemplate>
</asp:WebPartZone>
Należy również zauważyć, że ponieważ bazowa niestandardowa WebPart kontrolka --named TextDisplayWebPart
-- używana w przykładzie kodu ustawia AllowClose właściwość na false
w konstruktorze, <aspSample:TextDisplayPart>
element w katalogu musi ustawić AllowClose właściwość na true
, aby można było zamknąć kontrolkę w poniższym przykładzie kodu.
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
<asp:CatalogZone ID="CatalogZone1" Runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
Runat="server">
<WebPartsTemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
AllowClose="true"
ExportMode="All"
HelpMode="Modal"
HelpUrl="TextWebPartHelp.htm" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
<asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
</ZoneTemplate>
</asp:CatalogZone>
Po załadowaniu strony w przeglądarce przełącz stronę do trybu wyświetlania wykazu i dodaj kontrolkę TextDisplayWebPart
do strony. Możesz użyć pól wyboru, aby włączyć i wyłączyć czasownik zamknięcia, a następnie kliknąć czasownik Zamknij składnik Web Part w menu czasowników, aby zamknąć kontrolkę. Po zamknięciu kontrolki, jeśli wrócisz stronę do trybu wyświetlania wykazu, możesz kliknąć wykaz stron, wybrać oryginalne wystąpienie kontrolki TextDisplayWebPart
, która została zamknięta, i ponownie otworzyć ją na stronie.
Uwagi
Czasownik bliski, CloseVerb do który odwołuje się właściwość, pojawia się w menu czasowników każdej WebPart kontrolki w strefie.
Zamknięcie kontrolki usuwa ją z interakcji na stronie, chociaż jeśli deweloperzy udostępniają odpowiedni interfejs użytkownika(UI), taki jak CatalogZone strefa zawierająca PageCatalogPart kontrolkę, użytkownik może przełączyć stronę na CatalogDisplayMode stronę i dodać wcześniej zamknięte wystąpienie kontrolki z powrotem do strony.