Condividi tramite


WebPartZoneBase.CloseVerb Proprietà

Definizione

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.WebPartVerb
Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valore 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.

Si applica a

Vedi anche