CatalogZoneBase.AddVerb 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, das es Endbenutzern ermöglicht, einer Webparts-Seite Steuerelemente aus einem Katalog hinzuzufügen.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ AddVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb AddVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.AddVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property AddVerb As WebPartVerb

Eigenschaftswert

WebPartVerb

Ein WebPartVerb, das es Endbenutzern ermöglicht, einer Webseite Steuerelemente aus dem Katalog hinzuzufügen.

Attribute: PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie sowohl deklarativ als auch programmgesteuert auf die AddVerb 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 ApplyVerb Eigenschaft in einer Webseite zugreifen. In diesem Beispiel wird der Text 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 AddVerb Eigenschaft zugreifen, indem Sie eine Umschaltflä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 in den Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, können Sie den angepassten Text auf dem Button Steuerelement für das Add-Verb untersuchen und auf die Schaltfläche Verben aktivieren oder deaktivieren klicken, um zu zeigen, dass Sie programmgesteuert auf das anwendende Verb zugreifen können.

Hinweise

Auf das Add-Verb wird von der AddVerb -Eigenschaft eines steuerelements verwiesen, das von der CatalogZoneBase -Klasse abgeleitet ist. Das Add-Verb fügt einer Webseite ein Steuerelement hinzu, das ein Endbenutzer im Katalog ausgewählt hat. In der Regel wird das Add-Verb in der Benutzeroberfläche (UI) als Button Steuerelement angezeigt, obwohl es sich auch um einen Link oder ein Bild handeln kann.

Das Add-Verb ist ein Steuerelement auf Zonenebene, was bedeutet, dass das Add-Verb, obwohl es mehrere CatalogPart Steuerelemente im Katalog gibt, auf alle vom Benutzer ausgewählten Steuerelemente angewendet und der ausgewählten Zone hinzugefügt wird.

Gilt für:

Freigeben über