WebPartZoneBase.CloseVerb Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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à

WebPartVerb

Oggetto WebPartVerb che consente agli utenti finali di chiudere i controlli WebPart.

Attributi
PersistenceModeAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso CloseVerb della proprietà in un WebPartZone controllo. Per il funzionamento dell'esempio di codice, è necessario tutto il codice dalla sezione Esempio della HelpVerb proprietà.

La parte seguente dell'esempio di codice proviene dalla classe parziale e contiene il codice che attiva o disattiva se il verbo della Guida è abilitato o disabilitato.

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 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 sottostante WebPart denominato TextDisplayWebPart-- usato nell'esempio di codice imposta la proprietà su nel relativo costruttore, l'elemento <aspSample:TextDisplayPart> nel catalogo deve impostare la AllowCloseAllowClose proprietà su falsetrue, 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 la pagina in modalità di visualizzazione del catalogo e aggiungere il TextDisplayWebPart controllo alla pagina. È possibile usare le caselle di controllo per abilitare e disabilitare il verbo di chiusura e 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 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 CatalogZone una zona contenente 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