Compartilhar via


WebPart.Verbs Propriedade

Definição

Obtém uma coleção de verbos personalizados associados a um controle 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 da propriedade

Um WebPartVerbCollection que contém objetos personalizados WebPartVerb associados a um WebPart controle . O valor padrão é Empty.

Implementações

Atributos

Exemplos

O exemplo de código a seguir demonstra como acessar a Verbs propriedade para um controle de Web Parts personalizado. Este exemplo pressupõe o uso de um controle personalizado, TextDisplayWebPart, criado na seção Exemplo da visão geral da WebPart classe.

Observe que, para que o exemplo de código funcione, você deve adicionar uma configuração no arquivo Web.config para habilitar a exportação de arquivos de descrição de Web Parts. Verifique se você tem um arquivo Web.config no mesmo diretório que a página da Web para este exemplo de código. <system.web> Na seção , verifique se há um <webParts> elemento com um enableExport atributo definido truecomo , como na marcação a seguir.

<webParts enableExport="true">

...

</webParts>

Carregue a página da Web em um navegador. Quando você clica no botão Exibir Contagem de Verbos , ele acessa a Verbs propriedade para obter a contagem de verbos personalizados para o TextDisplayWebPart controle e exibe a contagem em um rótulo. Como nenhum verbo personalizado foi adicionado ao controle nesse caso, a contagem é zero.

<%@ 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>

Comentários

Os verbos derivam da WebPartVerb classe e fornecem ações de interface do usuário que os usuários podem executar em um WebPart controle. Normalmente, os verbos são representados na interface do usuário como botões, links ou itens de menu. Por padrão, verbos de Web Parts comuns aparecem em um menu de verbos suspensos na barra de título de cada WebPart controle. Há verbos padrão para abrir, fechar, editar e minimizar um controle e outros verbos para exportar uma definição para o controle ou carregar um arquivo de Ajuda. Esses verbos não estão incluídos na Verbs coleção, pois a coleção contém apenas verbos personalizados que você cria e retorna substituindo essa propriedade em uma classe derivada.

Ao criar verbos personalizados e adicioná-los à Verbs coleção, você pode acessar os verbos programaticamente de um WebPart controle.

Notas aos Herdeiros

Classes derivadas podem substituir a Verbs propriedade para permitir que os usuários adicionem objetos personalizados WebPartVerb à coleção de verbos para um WebPart controle .

Aplica-se a

Confira também