WebPartZoneBase.CloseVerb Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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, mit dem Endbenutzer WebPart-Steuerelemente schließen können.

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 Abschnitt Beispiel der HelpVerb -Eigenschaft.

Der folgende Teil des Codebeispiels stammt aus der partiellen Klasse und enthält den Code, der umschalten kann, 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 hostet 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 Verbenmenü 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 außerdem, dass das im Codebeispiel verwendete zugrunde liegende benutzerdefinierte WebPart Steuerelement mit dem Namen TextDisplayWebPart-- die Eigenschaft in seinem AllowClose Konstruktor auf false festlegt, das <aspSample:TextDisplayPart> Element im Katalog die AllowClose -Eigenschaft auf truefestlegen muss, 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 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 auf das Verb WebPart schließen klicken, um das Steuerelement zu schließen. Wenn Sie nach dem Schließen des Steuerelements die Seite in den Kataloganzeigemodus zurückkehren, können Sie 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ßen-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 wechseln und der Seite eine zuvor geschlossene Instanz eines Steuerelements wieder hinzufügen.

Gilt für:

Freigeben über