CatalogZoneBase.AddVerb Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales agregar controles de un catálogo a una página de elementos Web.

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

Valor de propiedad

WebPartVerb

Un objeto WebPartVerb que permite a los usuarios finales agregar controles del catálogo a una página Web.

Atributos
PersistenceModeAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener acceso a la AddVerb propiedad mediante declaración y mediante programación. Para obtener el código completo necesario para ejecutar el ejemplo, consulte la sección Ejemplo de la información general de la CatalogZoneBase clase.

La primera parte del ejemplo de código muestra cómo obtener acceso a la ApplyVerb propiedad mediante declaración en una página web. En este ejemplo se personaliza el texto del verbo.

<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." />

En la segunda parte del ejemplo se muestra cómo obtener acceso a la AddVerb propiedad mediante programación, mediante un botón de alternancia para habilitarla o deshabilitarla.

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

Al cargar la página en un explorador, puede seleccionar Catálogo en la lista desplegable para cambiar al modo de presentación del catálogo. Cuando el catálogo está visible, puede examinar el texto personalizado en el Button control para agregar verbo y puede hacer clic en el botón Habilitar o Deshabilitar verbos para demostrar que puede acceder al verbo aplicar mediante programación.

Comentarios

La propiedad de un control derivado de la CatalogZoneBase clase hace referencia AddVerb al verbo add. El verbo add agrega un control que un usuario final ha seleccionado en el catálogo a una página web. Normalmente, el verbo add aparece en la interfaz de usuario (UI) como un Button control, aunque también puede ser un vínculo o una imagen.

El verbo add es un control de nivel de zona, lo que significa que, aunque puede haber varios CatalogPart controles en el catálogo, el verbo add se aplica a todos los controles seleccionados por el usuario y los agrega a la zona seleccionada.

Se aplica a

Consulte también