WebPart.Verbs Propiedad

Definición

Obtiene una colección de verbos personalizados asociados a un control WebPart.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ Verbs { System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection Verbs { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Verbs : System.Web.UI.WebControls.WebParts.WebPartVerbCollection
Public Overridable ReadOnly Property Verbs As WebPartVerbCollection

Valor de propiedad

Colección WebPartVerbCollection que contiene los objetos WebPartVerb personalizados asociados a un control WebPart. El valor predeterminado es Empty.

Implementaciones

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener acceso a la Verbs propiedad de un control de elementos web personalizados. En este ejemplo se supone el uso de un control personalizado, TextDisplayWebPart, creado en la sección Ejemplo de la información general de la WebPart clase.

Tenga en cuenta que para que el ejemplo de código funcione, debe agregar una configuración en el archivo Web.config para habilitar la exportación de archivos de descripción de elementos web. Asegúrese de que tiene un archivo Web.config en el mismo directorio que la página web para este ejemplo de código. En la <system.web> sección , asegúrese de que hay un <webParts> elemento con un enableExport atributo establecido trueen , como en el marcado siguiente.

<webParts enableExport="true">

...

</webParts>

Cargue la página web en un explorador. Al hacer clic en el botón Mostrar recuento de verbos, obtiene acceso a la Verbs propiedad para obtener el recuento de verbos personalizados para el TextDisplayWebPart control y muestra el recuento en una etiqueta. Dado que no se han agregado verbos personalizados al control en este caso, el recuento es cero.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

void  button1_Click(object sender, EventArgs e)
{
  label1.Text = "Verb count = " + 
    textwebpart.Verbs.Count.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      OnClick="button1_Click" 
      Text="Display Verb Count" 
      />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    label1.Text = "Verb Count = " & _
      textwebpart.Verbs.Count.ToString()
    
  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            ExportMode="all" />        
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      Text="Display Verb Count" OnClick="button1_Click" />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

Comentarios

Los verbos derivan de la WebPartVerb clase y proporcionan acciones de interfaz de usuario (UI) que los usuarios pueden realizar en un WebPart control. Normalmente, los verbos se representan en la interfaz de usuario como botones, vínculos o elementos de menú. De forma predeterminada, los verbos comunes de elementos web aparecen en un menú de verbos desplegables en la barra de título de cada WebPart control. Hay verbos estándar para abrir, cerrar, editar y minimizar un control y otros verbos para exportar una definición para el control o cargar un archivo de Ayuda. Estos verbos no se incluyen en la Verbs colección, ya que la colección contiene solo verbos personalizados que se crean y devuelven reemplazando esta propiedad en una clase derivada.

Al crear verbos personalizados y agregarlos a la Verbs colección, puede acceder a los verbos mediante programación desde un WebPart control.

Notas a los desarrolladores de herederos

Las clases derivadas pueden invalidar la Verbs propiedad para permitir que los usuarios agreguen objetos personalizados WebPartVerb a la colección de verbos de un WebPart control.

Se aplica a

Consulte también