WebPartVerb Clase

Definición

Ofrece un elemento interactivo de interfaz de usuario que permite realizar acciones en una página de elementos web.Provides an interactive user interface (UI) element that enables users to perform actions on a Web Parts page.

public ref class WebPartVerb : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))]
public class WebPartVerb : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))>]
type WebPartVerb = class
    interface IStateManager
Public Class WebPartVerb
Implements IStateManager
Herencia
WebPartVerb
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un WebPartVerb objeto personalizado y una zona personalizada que utiliza el OnCreateVerbs método para agregar el verbo al menú de verbos de cada WebPart control contenido en la zona.The following code example shows how to create a custom WebPartVerb object, and a custom zone that uses the OnCreateVerbs method to add the verb to the verbs menu of each WebPart control contained in the zone. Hay cuatro partes en el ejemplo de código:There are four parts to the code example:

  • Archivo de código fuente que contiene un control personalizado simple WebPart que muestra texto.A source file that contains a simple custom WebPart control that displays some text.

  • Un archivo de código fuente que contiene un WebPartVerb objeto personalizado y una zona personalizada simple WebPartZoneBase que invalida el OnCreateVerbs método para agregar el verbo personalizado a WebPart los controles de la zona.A source file that contains a custom WebPartVerb object, and a simple custom WebPartZoneBase zone that overrides the OnCreateVerbs method to add the custom verb to WebPart controls in the zone.

  • Una página web que contiene la zona personalizada y el WebPart control personalizado.A Web page that contains the custom zone and the custom WebPart control.

  • Explicación de cómo funciona el ejemplo.An explanation of how the example works.

La primera parte del ejemplo de código contiene código fuente que crea un WebPart control simple que muestra texto.The first part of the code example contains source code that creates a simple WebPart control that displays some text. Para que el ejemplo de código se ejecute, debe compilar este código fuente.For the code example to run, you must compile this source code. Puede compilarlo explícitamente y colocar el ensamblado resultante en la carpeta bin del sitio web o en la caché global de ensamblados.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Como alternativa, puede colocar el código fuente en la carpeta App_Code del sitio, donde se compilará dinámicamente en tiempo de ejecución.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. En este ejemplo de código se utiliza el enfoque de compilación dinámica.This code example uses the dynamic compilation approach. Para ver un tutorial que muestra cómo compilar, vea Tutorial: desarrollar y utilizar un control de servidor web personalizado.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{

    // This code snippet creates a simple Web Part control.
    [AspNetHostingPermission(SecurityAction.Demand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    public class SimpleControl : WebPart
    {

        private String _text = "Simple control text";

        public string Text
        {
            get
            {
                if (_text != null)
                    return _text;
                else
                    return string.Empty;
            }
            set { _text = value; }
        }

        protected override void Render(System.Web.UI.HtmlTextWriter 
      writer)
        {
            writer.Write(this.Text);
        }
    }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Collections.Generic
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code snippet creates a simple Web Part control.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class SimpleControl
    Inherits System.Web.UI.WebControls.WebParts.WebPart

    Private _text As String = "Simple control text"

    Public Property [Text]() As String
      Get
        If Not (_text Is Nothing) Then
          Return _text
        Else
          Return String.Empty
        End If
      End Get
      Set(ByVal value As String)
        _text = value
      End Set
    End Property

    Protected Overrides Sub Render(ByVal writer _
      As System.Web.UI.HtmlTextWriter)

      writer.Write(Me.Text)

    End Sub

  End Class

End Namespace

La segunda parte del ejemplo contiene el código fuente para crear la zona personalizada y el WebPartVerb objeto personalizado.The second part of the example contains source code to create the custom zone and the custom WebPartVerb object. Tenga en cuenta que la zona invalida el OnCreateVerbs método para agregar el verbo personalizado a los WebPart controles de la zona.Note that the zone overrides the OnCreateVerbs method to add the custom verb to any WebPart controls in the zone. El verbo se agrega de forma predeterminada al menú de verbos de los controles.The verb is added by default to the verbs menu of the controls. Tenga en cuenta que, en el código del verbo personalizado, el constructor del verbo usa un controlador de clic de servidor y que el método llamado crea una copia completa de cualquier control que herede directamente de la WebPart clase, agregando la copia recién creada a la misma zona.Note that, in the code for the custom verb, the constructor for the verb uses a server click handler, and that the method called creates a complete copy of any control that inherits directly from the WebPart class, adding the newly created copy to the same zone. Como la primera parte del ejemplo de código, este código fuente se debe compilar y, en este ejemplo, el archivo de código fuente se colocó en una App_Code subcarpeta que se va a compilar dinámicamente.Like the first part of the code example, this source code must be compiled, and in this example the source file was placed in an App_Code subfolder to be dynamically compiled.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
/* 
This code sample creates a Web Part zone and adds the 
"Copy Web Part" verb to any control in the zone.
*/
[AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
public class ZoneWithAddedVerb : WebPartZone
{

  protected override void OnCreateVerbs(WebPartVerbsEventArgs e)
  {
    List<WebPartVerb> newVerbs = new List<WebPartVerb>();
    newVerbs.Add(new CopyWebPartVerb(CopyWebPartToNewOne));
    e.Verbs = new WebPartVerbCollection(e.Verbs,newVerbs);
    base.OnCreateVerbs(e);
  }

  void CopyWebPartToNewOne(object sender, WebPartEventArgs e)
  {
    WebPartManager wpmgr = 
      WebPartManager.GetCurrentWebPartManager(Page);
    System.Web.UI.WebControls.WebParts.WebPart wp;
    Type tp = e.WebPart.GetType(); 
    wp = (System.Web.UI.WebControls.WebParts.WebPart)Activator.CreateInstance(tp);   
    wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1);
  }
}
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  internal class CopyWebPartVerb : WebPartVerb
  {
    private const String _copyWebPartImageUrl = "~/CopyVerb.ico";

    internal CopyWebPartVerb(WebPartEventHandler serverClickHandler) :  
       base("MyVerb", serverClickHandler)
    { }
    public override string Text
    {
      get { return "Copy Web Part"; }
      set { ;}
    }
    public override string Description
    {
      get { return "This verb will copy this web part control " +
        "to a new one below"; }
      set { ; }
    }
    public override bool Enabled
    {
      get { return base.Enabled; }
      set { base.Enabled = value; }
    }
    
    public override string ImageUrl
    {
      get { return _copyWebPartImageUrl; }
      set { ; }
    }
  }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Collections.Generic
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code sample creates a Web Part zone and adds the 
' "Copy Web Part" verb to any control in the zone.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZoneWithAddedVerb
    Inherits WebPartZone

    'public class ExtendedWebPartZoneBase 
    Protected Overrides Sub OnCreateVerbs(ByVal e _
      As WebPartVerbsEventArgs)

      Dim newVerbs As List(Of WebPartVerb) = _
        New List(Of WebPartVerb)
      newVerbs.Add(New CopyWebPartVerb(AddressOf CopyWebPartToNewOne))
      e.Verbs = New WebPartVerbCollection(e.Verbs, newVerbs)
      MyBase.OnCreateVerbs(e)

    End Sub


    Sub CopyWebPartToNewOne(ByVal sender As Object, _
      ByVal e As WebPartEventArgs)

      Dim wpmgr As WebPartManager = _
        WebPartManager.GetCurrentWebPartManager(Page)
      Dim wp As System.Web.UI.WebControls.WebParts.WebPart
      Dim tp As Type = e.WebPart.GetType()
      wp = CType(Activator.CreateInstance(tp), _
        System.Web.UI.WebControls.WebParts.WebPart)
      wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Friend Class CopyWebPartVerb
    Inherits WebPartVerb
    Private Const _copyWebPartImageUrl As String = "~/CopyVerb.ico"

    Friend Sub New(ByVal serverClickHandler As WebPartEventHandler)
      MyBase.New("MyVerb", serverClickHandler)

    End Sub

    Public Overrides Property [Text]() As String
      Get
        Return "Copy Web Part"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Description() As String
      Get
        Return "This verb will copy this web part control to a " _
               & "new one below"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Enabled() As Boolean
      Get
        Return MyBase.Enabled
      End Get
      Set(ByVal value As Boolean)
        MyBase.Enabled = value
      End Set
    End Property
    
    Public Overrides Property ImageUrl() As String
      Get
        Return Me._copyWebPartImageUrl
      End Get
      Set(ByVal value As String)
      End Set
    End Property

  End Class

End Namespace

La tercera parte del ejemplo de código es la página web que hospeda los controles.The third part of the code example is the Web page that hosts the controls. Tenga en cuenta que hay una Register Directiva cerca de la parte superior de la página para declarar el espacio de nombres de los controles personalizados.Note that there is a Register directive near the top of the page to declare the namespace of the custom controls. No se declara ningún ensamblado porque este ejemplo utiliza la compilación dinámica.No assembly is declared because this example uses dynamic compilation. El WebPart control personalizado se declara dentro de la zona personalizada.The custom WebPart control is declared within the custom zone. También puede declarar otros WebPart controles en esta zona, y el verbo personalizado también se agregaría a sus menús de verbos.You could also declare other WebPart controls in this zone, and the custom verb would be added to their verbs menus as well.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="verbsample" 
    namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="verbsample" 
    namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>

Cargue la página en un explorador y haga clic en el menú de verbos del WebPart control personalizado.Load the page in a browser, and click the verbs menu on the custom WebPart control. El verbo copiar elemento Web debe estar visible.The Copy Web Part verb should be visible. Haga clic en el verbo y observe que se ha agregado una copia del control a la zona.Click the verb, and note that a copy of the control is added to the zone.

Comentarios

Elementos web verbos son elementos de interfaz de usuario interactivos, normalmente representados por botones o hipervínculos, que aparecen en las páginas que usan controles de elementos web.Web Parts verbs are interactive UI elements, typically represented by buttons or hyperlinks, that appear in pages that use Web Parts controls. Los usuarios hacen clic en los verbos para llevar a cabo acciones comunes de la interfaz de usuario para elementos web controles, como cerrar un WebPart control o cerrar el modo de presentación de edición (una vista de página especial asociada al EditorZone control).Users click verbs to carry out common UI actions for Web Parts controls, such as closing a WebPart control or closing the edit display mode (a special page view associated with the EditorZone control). Todos los verbos estándar que se proporcionan con el conjunto de controles elementos Web están asociados a una zona elementos Web ( WebPartZone , EditorZone , CatalogZone o ConnectionsZone ) o un Part control elementos Web ( WebPart , GenericWebPart , EditorPart o CatalogPart ).All standard verbs provided with the Web Parts control set are associated with either a Web Parts zone (WebPartZone, EditorZone, CatalogZone, or ConnectionsZone) or a Web Parts Part control (WebPart, GenericWebPart, EditorPart, or CatalogPart).

Cuando los verbos estándar están asociados a una zona, sus acciones se aplican en el nivel de zona y los verbos suelen aparecer en el área de encabezado o pie de página de la zona.When the standard verbs are associated with a zone, their actions apply at the zone level, and the verbs usually appear in the zone's header or footer area. En la tabla siguiente se enumeran los verbos de nivel de zona comunes y se describen sus acciones.The following table lists the common zone-level verbs and describes their actions.

Verbo de nivel de zonaZone-level verb AcciónAction
Verbo cerrarClose verb Se usa con zonas que heredan de la ToolZone clase.Used with zones that inherit from the ToolZone class. Oculta la interfaz de usuario de una zona y normalmente devuelve la página a su vista de modo de exploración normal.Hides the UI for a zone and typically returns the page to its normal browse mode view.
Aplicar verboApply verb Se usa con zonas que heredan de la EditorZoneBase clase.Used with zones that inherit from the EditorZoneBase class. Aplica los cambios realizados por un usuario.Applies changes that a user has made.
Verbo aceptarOK verb Se usa con zonas que heredan de la EditorZoneBase clase.Used with zones that inherit from the EditorZoneBase class. Tiene el efecto combinado de los verbos Apply y Close; aplica los cambios y oculta la interfaz de usuario de la zona.Has the combined effect of the apply and close verbs; it applies changes and hides the zone's UI.
Cancelar verboCancel verb Se usa con zonas que heredan de la ToolZone clase.Used with zones that inherit from the ToolZone class. Cancela los cambios pendientes que ha realizado un usuario.Cancels any pending changes a user has made.
Agregar verboAdd verb Se usa con zonas que heredan de la CatalogZoneBase clase.Used with zones that inherit from the CatalogZoneBase class. Agrega un control que un usuario ha seleccionado de un catálogo de controles a una WebPartZone zona especificada.Adds a control that a user has selected from a catalog of controls to a specified WebPartZone zone.
Configurar verboConfigure verb Se usa con zonas que heredan de la ConnectionsZone clase.Used with zones that inherit from the ConnectionsZone class. Abre una vista para permitir que los usuarios configuren las conexiones existentes.Opens a view to enable users to configure existing connections.
Verbo desconectarDisconnect verb Se usa con zonas que heredan de la ConnectionsZone clase.Used with zones that inherit from the ConnectionsZone class. Finaliza una conexión existente entre dos controles.Terminates an existing connection between two controls.

Como en el caso de los verbos estándar que están asociados a Part controles, sus acciones se aplican al propio control (o a sus controles secundarios).As for the standard verbs that are associated with Part controls, their actions apply to the control itself (or to its child controls). El control de elementos actúa como contenedor del verbo y administra la representación del verbo.The part control acts as a container for the verb and manages the rendering of the verb. La mayoría de los verbos estándar asociados a controles de elementos aparecen directamente en la barra de título o en un menú de verbos desplegable dentro de la barra de título.Most standard verbs associated with part controls appear either directly in the title bar or in a drop-down verbs menu within the title bar. Si estos verbos aparecen directamente en el encabezado o en un menú de verbos viene determinado por la WebPartVerbRenderMode propiedad; de forma predeterminada, los verbos aparecen en un menú de verbos.Whether these verbs appear directly in the header or in a verbs menu is determined by the WebPartVerbRenderMode property; by default, the verbs appear in a verbs menu. En la tabla siguiente se enumeran los verbos comunes asociados a los distintos Part controles y se describen sus acciones.The following table lists common verbs associated with the various Part controls and describes their actions.

Verbo de control de elementosPart control verb AcciónAction
Minimizar verboMinimize verb Aparece en el menú de verbos de cada control de servidor incluido en una WebPartZoneBase zona.Appears in the verbs menu of each server control contained in a WebPartZoneBase zone. Reduce el control a una representación mínima y oculta todo en su interfaz de usuario, excepto el verbo de restauración.Reduces the control to a minimal representation, hiding everything in its UI except the restore verb.
Verbo de restauraciónRestore verb Aparece en el menú de verbos de cada control de servidor incluido en una WebPartZoneBase zona.Appears in the verbs menu of each server control contained in a WebPartZoneBase zone. Devuelve un control minimizado a su tamaño y vista normales.Returns a minimized control to its normal size and view.
Verbo cerrarClose verb Aparece en el menú de verbos de cada control de servidor incluido en una WebPartZoneBase zona.Appears in the verbs menu of each server control contained in a WebPartZoneBase zone. Cierra un control y lo agrega al catálogo de páginas, lo que significa que el control se quita de la página pero, si hay un catálogo diseñado correctamente, los usuarios pueden volver a abrir el control cerrado y devolverlo a la página.Closes a control and adds it to the page catalog, which means the control is removed from the page but, if there is a properly designed catalog, users can reopen the closed control and return it to the page.
Verbo CONNECTConnect verb Aparece en el menú de verbos de un control contenido en una WebPartZoneBase zona, si la página está en modo de presentación de conexión y si el control puede formar conexiones.Appears in the verbs menu of a control contained in a WebPartZoneBase zone, if the page is in connect display mode and if the control can form connections. Abre una interfaz de usuario de conexión para que los usuarios puedan crear una conexión entre los controles.Opens a connection UI so that users can create a connection between controls.
Eliminar verboDelete verb Aparece en el menú de verbos de un control contenido en una WebPartZoneBase zona, si el control se agregó a la página mediante programación (en lugar de declararse en formato de persistencia).Appears in the verbs menu of a control contained in a WebPartZoneBase zone, if the control was added to the page programmatically (rather than being declared in persistence format). Elimina de forma permanente la instancia del control y los datos de personalización asociados de modo que, a diferencia de un control cerrado, la instancia eliminada nunca se puede restaurar en la página.Permanently deletes the control instance and any associated personalization data so that, unlike a closed control, the deleted instance can never be restored to the page.
Editar verboEdit verb Aparece en el menú de verbos de un control contenido en una WebPartZoneBase zona, si la página está diseñada para permitir la edición de controles y si la página está en modo de presentación de edición.Appears in the verbs menu of a control contained in a WebPartZoneBase zone, if the page is designed to permit editing of controls and if the page is in edit display mode. Selecciona el control para editar y abre la interfaz de usuario de edición.Selects the control for editing and opens the editing UI.
Verbo ExportExport verb Aparece en el menú de verbos de un control contenido en una WebPartZoneBase zona, si el control y la aplicación están habilitados para la exportación.Appears in the verbs menu of a control contained in a WebPartZoneBase zone, if the control and application are enabled for export. Abre un cuadro de diálogo que permite a los usuarios exportar un archivo de descripción que contiene el estado serializado del control.Opens a dialog box that enables users to export a description file that contains the serialized state of the control. Para obtener más información, vea la propiedad ExportMode.For details, see the ExportMode property.
Verbo de ayudaHelp verb Aparece en el menú de verbos de un control contenido en una WebPartZoneBase zona, si el control está diseñado para proporcionar un archivo de ayuda.Appears in the verbs menu of a control contained in a WebPartZoneBase zone, if the control is designed to provide a Help file. Inicia una página que proporciona ayuda para el control.Launches a page that provides help for the control.

Además de los verbos estándar que se proporcionan con el conjunto de controles elementos web, también puede crear verbos personalizados.Along with the standard verbs that are provided with the Web Parts control set, you can also create custom verbs. Un escenario común para crear verbos personalizados es crear verbos asociados a Part controles.A common scenario for creating custom verbs is to create verbs associated with Part controls. Al crear estos verbos, de forma predeterminada aparecerán en el menú de verbos junto con los verbos estándar.When you create these verbs, by default they will appear on the verbs menu along with the standard verbs. El enfoque básico para crear estos verbos es heredar de la WebPartVerb clase para crear uno o más verbos personalizados.The basic approach for creating such verbs is to inherit from the WebPartVerb class to create one or more custom verbs. A continuación, cree un control que herede de la WebPart clase base y agregue los WebPartVerb objetos personalizados a una WebPartVerbCollection colección.Then create a control that inherits from the WebPart base class and add the custom WebPartVerb objects to a WebPartVerbCollection collection. Esta colección se puede Agregar a continuación a la Verbs colección del control, lo que hará que los verbos personalizados aparezcan automáticamente en el menú de verbos del control en tiempo de ejecución.This collection can then be added to the Verbs collection of the control, which will cause the custom verbs to appear automatically on the control's verbs menu at run time. Al igual que con los verbos estándar, puede tener acceso a los verbos personalizados mediante programación en un WebPart control.As with the standard verbs, you can access the custom verbs programmatically on a WebPart control.

Elementos web aplicaciones pueden utilizar controles de servidor que no heredan de la WebPart clase, como controles personalizados, controles de usuario o controles ASP.net.Web Parts applications can use server controls that do not inherit from the WebPart class, such as custom controls, user controls, or ASP.NET controls. Estos controles de servidor, si se agregan a una WebPartZoneBase zona, se ajustan dinámicamente con un GenericWebPart objeto en tiempo de ejecución, lo que les permite funcionar como controles en tiempo de ejecución WebPart .These server controls, if added to a WebPartZoneBase zone, are dynamically wrapped with a GenericWebPart object at run time, which enables them to function as run-time WebPart controls. Para agregar verbos personalizados a un control de servidor que no se hereda de la WebPart clase, el control de servidor debe implementar la IWebActionable interfaz e invalidar su Verbs propiedad.To add custom verbs to a server control that does not inherit from the WebPart class, the server control must implement the IWebActionable interface and override its Verbs property.

Al crear un verbo, puede crear dos tipos de controladores de eventos asociados que se ejecutarán cuando un usuario haga clic en el verbo: un controlador de eventos de servidor (código que se ejecuta en el servidor) y un controlador de eventos del lado cliente (código que se ejecuta en el explorador del cliente).When you create a verb, you can create two types of associated event handlers that will run when a user clicks the verb: a server-side event handler (code that runs on the server), and a client-side event handler (code that runs in the client browser). Además, puede definir Estados personalizados para los verbos, que es una manera útil de proporcionar indicaciones visuales a los usuarios.Also, you can define custom states for verbs, which is a useful way to provide visual cues to users. Por ejemplo, puede crear un estado que indique que se ha seleccionado un verbo y, a continuación, proporcionar los cambios adecuados en la interfaz de usuario para notificar al usuario que el verbo ya está seleccionado.For example, you could create a state indicating that a verb has been selected, and then provide appropriate changes in the UI to notify the user that the verb is already selected. Otro comportamiento útil es la capacidad de deshabilitar verbos; al hacerlo, puede impedir que los usuarios hagan clic en verbos si esto sería perjudicial o ineficaz según el estado de la aplicación.Another useful behavior is the ability to disable verbs; by doing this, you can prevent users from clicking verbs if doing so would be harmful or ineffective based on the state of the application.

La WebPartVerb clase no expone ningún método único; sus métodos expuestos son invalidaciones de los métodos base.The WebPartVerb class does not expose any unique methods; its exposed methods are all overrides of base methods. Sin embargo, contiene una serie de propiedades que los desarrolladores deben tener en cuenta.It does however contain a number of properties for developers to be aware of. La Checked propiedad indica si un verbo está seleccionado actualmente.The Checked property indicates whether a verb is currently selected. Las ClientClickHandler ServerClickHandler propiedades y hacen referencia a los controladores respectivos dentro de la clase (si existen) para los eventos de clic de cliente y servidor.The ClientClickHandler and ServerClickHandler properties refer to the respective handlers within the class (if any exist) for client and server click events. La Description propiedad contiene texto que describe el propósito de un verbo en una información sobre herramientas cuando los usuarios colocan un puntero del mouse sobre el verbo en la interfaz de usuario.The Description property contains text that describes the purpose of a verb in a ToolTip when users position a mouse pointer over the verb in the UI. La Enabled propiedad indica el estado actual de un verbo, que determina si un usuario puede hacer clic en el verbo y ejecutar su acción.The Enabled property indicates the current status of a verb, which determines whether a user can click the verb and execute its action. La ID propiedad proporciona un identificador único para el objeto Verb.The ID property provides a unique ID for the verb object. La ImageUrl propiedad contiene una dirección URL a una imagen que se puede usar para representar un verbo en la interfaz de usuario en lugar de la representación predeterminada (normalmente un botón o un hipervínculo).The ImageUrl property contains a URL to an image that can be used to represent a verb in the UI in place of the default rendering (typically a button or a hyperlink). La Text propiedad contiene el texto de la etiqueta que aparece directamente en el verbo en la interfaz de usuario.The Text property contains the label text that appears directly on the verb in the UI. La propiedad reemplazada Visible determina si un verbo se muestra actualmente en la interfaz de usuario.The overridden Visible property determines whether a verb is currently displayed in the UI. Los verbos suelen estar ocultos o deshabilitados en distintos momentos en una aplicación elementos web; por ejemplo, los verbos de especialidad (como el verbo de edición y el verbo CONNECT) solo se muestran cuando existen los controles, la configuración y los modos de presentación adecuados en la página para permitir que esos verbos realicen una acción significativa.Verbs are often hidden or disabled at different times in a Web Parts application; for example, specialty verbs (such as the edit verb and the connect verb) are displayed only when the appropriate controls, settings, and display modes exist on the page to enable those verbs to take meaningful action.

Otros miembros clave para trabajar con verbos incluyen el WebPartZoneBase.OnCreateVerbs método, que es un controlador de eventos que se puede invalidar para el control personalizado del proceso de creación del verbo y el WebPartZoneBase.CreateVerbs evento.Other key members for working with verbs include the WebPartZoneBase.OnCreateVerbs method, which is an event handler that can be overridden for custom handling of the verb creation process, and the WebPartZoneBase.CreateVerbs event.

Constructores

WebPartVerb(String, String)

Inicializa una nueva instancia de la clase WebPartVerb y asocia un controlador de eventos Click del cliente a la instancia.Initializes a new instance of the WebPartVerb class and associates a client-side click event handler with the instance.

WebPartVerb(String, WebPartEventHandler)

Inicializa una nueva instancia de la clase WebPartVerb y asocia un controlador de eventos Click del servidor a la instancia.Initializes a new instance of the WebPartVerb class and associates a server-side click event handler with the instance.

WebPartVerb(String, WebPartEventHandler, String)

Inicializa una nueva instancia de la clase WebPartVerb y asocia los dos controladores de eventos Click del cliente y del servidor a la instancia.Initializes a new instance of the WebPartVerb class and associates both client and server-side click event handlers with the instance.

Propiedades

Checked

Obtiene o establece un valor que indica que algún estado asociado a un verbo personalizado está activo o seleccionado en la actualidad.Gets or sets a value indicating that some state associated with a custom verb is currently active or selected.

ClientClickHandler

Obtiene la cadena que contiene el nombre de método del controlador de eventos del cliente definida en el constructor WebPartVerb.Gets the string containing the method name of the client-side event handler defined in the WebPartVerb constructor.

Description

Obtiene o establece una descripción abreviada del verbo.Gets or sets a short description of the verb.

Enabled

Obtiene o establece un valor que indica si está habilitado un verbo.Gets or sets a value that indicates whether a verb is enabled.

ID

Obtiene una cadena que contiene un identificador único para un verbo.Gets a string containing a unique ID for a verb.

ImageUrl

Obtiene o establece una cadena que contiene una dirección URL de una imagen que representa un verbo en la interfaz de usuario.Gets or sets a string containing a URL to an image that represents a verb in the user interface (UI).

IsTrackingViewState

Obtiene un valor que indica si actualmente se está efectuando un seguimiento del estado de vista de un verbo.Gets a value that indicates whether view state is currently being tracked for a verb.

ServerClickHandler

Obtiene una referencia al método que controla los eventos Click de servidor del verbo.Gets a reference to the method that handles server-side click events for the verb.

Text

Obtiene o establece la etiqueta de texto de un verbo que se muestra en la interfaz de usuario.Gets or sets the text label for a verb that is displayed in the user interface (UI).

ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

Visible

Obtiene o establece un valor que indica si un verbo está visible para los usuarios.Gets or sets a value that indicates whether a verb is visible to users.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
LoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
SaveViewState()

Guarda los cambios del estado de vista del objeto WebPartVerb que se han efectuado desde la última vez que la página se envió al servidor.Saves a WebPartVerb object's view-state changes that occurred since the page was last posted back to the server.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TrackViewState()

Realiza el seguimiento de los cambios del estado de vista de un verbo para que estos cambios se puedan almacenar en el objeto StateBag del control.Tracks view-state changes to a verb so the changes can be stored in the verb's StateBag object.

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Implementa la propiedad IsTrackingViewState llamando a la propiedad WebPartVerb de la clase IsTrackingViewState.Implements the IsTrackingViewState property by calling the WebPartVerb class's own IsTrackingViewState property.

IStateManager.LoadViewState(Object)

Implementa el método LoadViewState(Object) de la interfaz IStateManager llamando al propio método WebPartVerb de la clase LoadViewState(Object).Implements the LoadViewState(Object) method of the IStateManager interface by calling the WebPartVerb class's own LoadViewState(Object) method.

IStateManager.SaveViewState()

Implementa el método SaveViewState() llamando al propio método WebPartVerb de la clase SaveViewState().Implements the SaveViewState() method by calling the WebPartVerb class's own SaveViewState() method.

IStateManager.TrackViewState()

Implementa el método TrackViewState() llamando al propio método WebPartVerb de la clase TrackViewState().Implements the TrackViewState() method by calling the WebPartVerb class's own TrackViewState() method.

Se aplica a

Consulte también