CatalogZoneBase.CloseVerb Eigenschaft

  • Referenz

Definition

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

Ruft einen Verweis auf ein WebPartVerb-Objekt ab, das es Endbenutzern ermöglicht, die Benutzeroberfläche des Katalogs zu schließen und die Seite in den normalen Durchsuchen-Modus zurückzuschalten.

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, das es Endbenutzern ermöglicht, die Benutzeroberfläche des Katalogs für die Webseite zu schließen.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie sowohl deklarativ als auch programmgesteuert auf die CloseVerb Eigenschaft zugreifen. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Der erste Teil des Codebeispiels zeigt, wie Sie deklarativ auf die CloseVerb Eigenschaft auf einer Webseite zugreifen. In diesem Beispiel wird die Description Eigenschaft für das Verb angepasst.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

Der zweite Teil des Beispiels zeigt, wie Sie programmgesteuert auf die CloseVerb Eigenschaft zugreifen, indem Sie eine Umschaltschaltfläche verwenden, um sie zu aktivieren oder zu deaktivieren.

protected void Button1_Click(object sender, EventArgs e)
{
  if (CatalogZone1.AddVerb.Enabled)
  {
    CatalogZone1.AddVerb.Enabled = false;
    CatalogZone1.CloseVerb.Enabled = false;
  }
  else
  {
    CatalogZone1.AddVerb.Enabled = true;
    CatalogZone1.CloseVerb.Enabled = true;
  }
}

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  If CatalogZone1.AddVerb.Enabled Then
    CatalogZone1.AddVerb.Enabled = False
    CatalogZone1.CloseVerb.Enabled = False
  Else
    CatalogZone1.AddVerb.Enabled = True
    CatalogZone1.CloseVerb.Enabled = True
  End If

End Sub

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um zum Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, können Sie den Beschreibungstext in einer QuickInfo anzeigen, indem Sie den Mauszeiger über die Schaltfläche Schließen positionieren. Sie können auch auf die Schaltfläche Verben aktivieren oder deaktivieren klicken, um zu veranschaulichen, dass Sie programmgesteuert auf das schließende Verb zugreifen können.

Hinweise

Auf das schließen-Verb wird von der CloseVerb -Eigenschaft für ein von der -Klasse abgeleitetes CatalogZoneBase Steuerelement verwiesen.

Der Benutzer kann auf das Schließen-Verb in der Zonenfußzeile klicken. Wenn der Benutzer auf das Verb schließen klickt, werden alle CatalogPart vom Benutzer ausgewählten Steuerelemente ignoriert, die Katalog-Benutzeroberfläche wird geschlossen, und die Seite kehrt in den normalen Suchmodus zurück.

Das Schließen-Verb ist ein Steuerelement auf Zonenebene, was bedeutet, dass seine Aktion auf der Ebene der gesamten Zone angewendet wird. Wenn ein Benutzer auf das Verb schließen klickt, werden alle Steuerelemente ignoriert, die der Seite nicht hinzugefügt wurden, der Katalog geschlossen, und die Seite kehrt in den Suchmodus zurück.

Gilt für:

Weitere Informationen