Sdílet prostřednictvím


WebPartZoneBase.CloseVerb Vlastnost

Definice

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zavřít WebPart ovládací prvky v zóně.

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

Hodnota vlastnosti

A WebPartVerb , který umožňuje koncovým uživatelům zavřít WebPart ovládací prvky.

Atributy

Příklady

Následující příklad kódu ukazuje použití CloseVerb vlastnosti v ovládacím prvku WebPartZone . Aby příklad kódu fungoval, potřebujete veškerý kód z části HelpVerb Example vlastnosti.

Následující část příkladu kódu pochází z částečné třídy a obsahuje kód, který přepíná, zda je příkaz nápovědy povolený nebo zakázaný.

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

Druhou částí příkladu kódu je webová stránka, která je hostitelem vlastního ovládacího prvku a obsahuje uživatelské rozhraní. Všimněte si, že deklarativní <CloseVerb> prvek v zóně nastaví konkrétní text, který představuje příkaz zavřít v nabídce sloves pro WebPart ovládací prvek.

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

Všimněte si také, že vzhledem k tomu, že základní vlastní WebPart ovládací prvek s názvem TextDisplayWebPart-- použitý v příkladu kódu nastaví AllowClose vlastnost na false ve svém konstruktoru <aspSample:TextDisplayPart> , musí element v katalogu nastavit AllowClose vlastnost na true, aby bylo možné ovládací prvek zavřít v následujícím příkladu kódu.

<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 načtení stránky v prohlížeči přepněte stránku do režimu zobrazení katalogu a přidejte TextDisplayWebPart na stránku ovládací prvek. Pomocí zaškrtávacích políček můžete povolit nebo zakázat příkaz zavřít a kliknutím na příkaz Zavřít webovou část v nabídce sloves ovládací prvek zavřít. Pokud po zavření ovládacího prvku vrátíte stránku do režimu zobrazení katalogu, můžete kliknout na Katalog stránek, vybrat původní instanci TextDisplayWebPart ovládacího prvku, který jste zavřeli, a znovu ho otevřít na stránce.

Poznámky

Příkaz zavřít, na který CloseVerb odkazuje vlastnost, se zobrazí v nabídce sloves každého WebPart ovládacího prvku v zóně.

Zavřením ovládacího prvku se odebere z interakce na stránce, i když pokud vývojáři zadají příslušné uživatelské rozhraní(UI), například zónu CatalogZone , která obsahuje PageCatalogPart ovládací prvek, může uživatel stránku přepnout na CatalogDisplayMode a přidat na ni dříve uzavřenou instanci ovládacího prvku.

Platí pro

Viz také