Freigeben über

WebPartZoneBase.CloseVerb Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft einen Verweis auf ein WebPartVerb Objekt ab, mit dem Endbenutzer die WebPart Steuerelemente in einer Zone schließen können.

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

Eigenschaftswert

WebPartVerb

Ein WebPartVerb Steuerelement, das Endbenutzern das Schließen von WebPart Steuerelementen ermöglicht.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der CloseVerb Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Damit das Codebeispiel funktioniert, benötigen Sie den gesamten Code aus dem Beispielabschnitt der HelpVerb Eigenschaft.

Der folgende Teil des Codebeispiels stammt aus der partiellen Klasse und enthält den Code, der umgeschaltet wird, ob das Hilfeverb aktiviert oder deaktiviert ist.

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

Der andere Teil des Codebeispiels ist die Webseite, die das benutzerdefinierte Steuerelement hosten und die Benutzeroberfläche enthält. Beachten Sie, dass das deklarative <CloseVerb> Element in der Zone den spezifischen Text festlegt, der das schließende Verb im Menü "Verben" für das WebPart Steuerelement darstellt.

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

Beachten Sie auch, dass das element im Katalog festgelegt werden muss, da das zugrunde liegende benutzerdefinierte WebPart Steuerelement mit dem Namen TextDisplayWebPart-- im Codebeispiel die AllowClose Eigenschaft false im Konstruktor festlegt, muss das <aspSample:TextDisplayPart> Element im Katalog die AllowClose Eigenschaft trueauf festlegen, damit das Steuerelement im folgenden Codebeispiel geschlossen werden kann.

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

Nachdem Sie die Seite in einem Browser geladen haben, wechseln Sie die Seite in den Kataloganzeigemodus, und fügen Sie das TextDisplayWebPart Steuerelement der Seite hinzu. Sie können die Kontrollkästchen verwenden, um das schließende Verb zu aktivieren und zu deaktivieren, und Sie können im Menü "Verben schließen" auf das Verb " Schließen " klicken, um das Steuerelement zu schließen. Nachdem Sie das Steuerelement geschlossen haben, können Sie beim Zurückgeben der Seite zum Kataloganzeigemodus auf den Seitenkatalog klicken, die ursprüngliche Instanz des TextDisplayWebPart steuerelements auswählen, das Sie geschlossen haben, und es auf der Seite erneut öffnen.

Hinweise

Das von der CloseVerb Eigenschaft referenzierte schließene Verb wird im Verbenmenü jedes WebPart Steuerelements in einer Zone angezeigt.

Durch das Schließen eines Steuerelements wird es aus der Interaktion auf einer Seite entfernt. Wenn Entwickler jedoch die entsprechende Benutzeroberfläche (UI) bereitstellen, z. B. eine CatalogZone Zone, die ein PageCatalogPart Steuerelement enthält, kann ein Benutzer die Seite in CatalogDisplayMode die Seite wechseln und eine zuvor geschlossene Instanz eines Steuerelements wieder zur Seite hinzufügen.

Gilt für:

Weitere Informationen