WebPartZoneBase.CloseVerb Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di chiudere i controlli WebPart di una zona.
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.WebPartVerbPublic Overridable ReadOnly Property CloseVerb As WebPartVerbValore della proprietà
Oggetto WebPartVerb che consente agli utenti finali di chiudere i controlli WebPart.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato l'uso della CloseVerb proprietà in un WebPartZone controllo . Per il funzionamento dell'esempio di codice, è necessario tutto il codice della sezione Example della HelpVerb proprietà .
La parte seguente dell'esempio di codice proviene dalla classe parziale e contiene il codice che attiva o disattiva il verbo della Guida.
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
L'altra parte dell'esempio di codice è la pagina Web che ospita il controllo personalizzato e contiene l'interfaccia utente. Si noti che l'elemento dichiarativo <CloseVerb> nella zona imposta il testo specifico che rappresenta il verbo di chiusura nel menu dei verbi per il WebPart controllo.
<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>
Si noti anche che, poiché il controllo personalizzato WebPart sottostante denominato TextDisplayWebPart, usato nell'esempio di codice imposta la AllowClose proprietà su false nel relativo costruttore, l'elemento <aspSample:TextDisplayPart> nel catalogo deve impostare la AllowClose proprietà su true, in modo che il controllo possa essere chiuso nell'esempio di codice seguente.
<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>
Dopo aver caricato la pagina in un browser, passare alla modalità di visualizzazione del catalogo e aggiungere il TextDisplayWebPart controllo alla pagina. È possibile utilizzare le caselle di controllo per abilitare e disabilitare il verbo di chiusura ed è possibile fare clic sul verbo Chiudi webPart nel menu verbi per chiudere il controllo. Dopo aver chiuso il controllo, se si restituisce la pagina alla modalità di visualizzazione del catalogo, è possibile fare clic su Catalogo pagine, selezionare l'istanza originale del TextDisplayWebPart controllo chiuso e riaprirla nella pagina.
Commenti
Il verbo di chiusura a cui fa riferimento la CloseVerb proprietà viene visualizzato nel menu dei verbi di ogni WebPart controllo in una zona.
La chiusura di un controllo lo rimuove dall'interazione in una pagina, anche se gli sviluppatori forniscono l'interfaccia utente appropriata, ad esempio una CatalogZone zona che contiene un PageCatalogPart controllo, un utente può passare alla pagina CatalogDisplayMode e aggiungere un'istanza precedentemente chiusa di un controllo alla pagina.
