WebPartZoneBase.CloseVerb Egenskap

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

Egenskapsvärde

En WebPartVerb som gör det möjligt för slutanvändare att stänga WebPart kontroller.

Attribut

PersistenceModeAttribute

Exempel

I följande kodexempel visas hur egenskapen används på CloseVerb en WebPartZone kontroll. För att kodexemplet ska fungera behöver du all kod från avsnittet Exempel i HelpVerb egenskapen.

Följande del av kodexemplet kommer från den partiella klassen och innehåller den kod som växlar om hjälpverb är aktiverat eller inaktiverat.

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

Den andra delen av kodexemplet är webbsidan som är värd för den anpassade kontrollen och innehåller användargränssnittet. Observera att det deklarativa <CloseVerb> elementet i zonen anger den specifika text som representerar det nära verbet i verbmenyn för WebPart kontrollen.

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

Observera också att eftersom den underliggande anpassade WebPart kontrollen med namnet TextDisplayWebPart, som används i kodexemplet anger AllowClose egenskapen till false i konstruktorn, <aspSample:TextDisplayPart> måste elementet i katalogen ange AllowClose egenskapen till true, så att kontrollen kan stängas i följande kodexempel.

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

När du har läst in sidan i en webbläsare växlar du sidan till katalogvisningsläge och lägger till TextDisplayWebPart kontrollen på sidan. Du kan använda kryssrutorna för att aktivera och inaktivera det nära verbet, och du kan klicka på verbet Stäng webbdel i verbmenyn för att stänga kontrollen. När du har stängt kontrollen, om du returnerar sidan till katalogvisningsläget, kan du klicka på sidkatalogen, välja den ursprungliga instansen av kontrollen TextDisplayWebPart som du stängde och öppna den på sidan igen.

Kommentarer

Det nära verb som egenskapen CloseVerb refererar till visas i verbmenyn för varje WebPart kontroll i en zon.

Om du stänger en kontroll tas den bort från interaktionen på en sida, men om utvecklare tillhandahåller lämpligt användargränssnitt (UI), till exempel en CatalogZone zon som innehåller en PageCatalogPart kontroll, kan en användare växla sidan till CatalogDisplayMode och lägga till en tidigare stängd instans av en kontroll tillbaka till sidan.

Se även

• CloseWebPart(WebPart)
• DeleteVerb
• ASP.NET webbdelskontroller