WebPart.Verbs Proprietà

Definizione

Ottiene un insieme di verbi personalizzati associati a un controllo 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

Valore della proprietà

Un oggetto WebPartVerbCollection che contiene oggetti WebPartVerb personalizzati associati a un controllo WebPart. Il valore predefinito è Empty.

Implementazioni

Attributi

Esempio

Nell'esempio di codice seguente viene illustrato come accedere alla Verbs proprietà per un controllo Web part personalizzato. In questo esempio si presuppone l'uso di un controllo personalizzato, TextDisplayWebPart, creato nella sezione Esempio della panoramica della WebPart classe.

Si noti che per il funzionamento dell'esempio di codice è necessario aggiungere un'impostazione nel file Web.config per consentire l'esportazione di file di descrizione web part. Assicurarsi di avere un file Web.config nella stessa directory della pagina Web per questo esempio di codice. All'interno della <system.web> sezione verificare che sia presente un elemento con un <webParts>enableExport attributo impostato su true, come nel markup seguente.

<webParts enableExport="true">

...

</webParts>

Caricare la pagina Web in un browser. Quando si fa clic sul pulsante Visualizza conteggio verbi , si accede alla Verbs proprietà per ottenere il numero di verbi personalizzati per il TextDisplayWebPart controllo e viene visualizzato il conteggio in un'etichetta. Poiché al controllo non sono stati aggiunti verbi personalizzati, in questo caso il conteggio è 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>

Commenti

I verbi derivano dalla WebPartVerb classe e forniscono azioni dell'interfaccia utente che gli utenti possono eseguire su un WebPart controllo. In genere i verbi sono rappresentati nell'interfaccia utente come pulsanti, collegamenti o voci di menu. Per impostazione predefinita, i verbi web part comuni vengono visualizzati in un menu dei verbi a discesa nella barra del titolo di ogni WebPart controllo. Sono disponibili verbi standard per l'apertura, la chiusura, la modifica e la riduzione al minimo di un controllo e altri verbi per l'esportazione di una definizione per il controllo o il caricamento di un file della Guida. Questi verbi non sono inclusi nell'insieme, perché l'insieme Verbs contiene solo verbi personalizzati creati e restituiti eseguendo l'override di questa proprietà in una classe derivata.

Quando si creano verbi personalizzati e li si aggiunge alla Verbs raccolta, è possibile accedere ai verbi a livello di codice da un WebPart controllo .

Note per gli eredi

Le classi derivate possono eseguire l'override della Verbs proprietà per consentire agli utenti di aggiungere oggetti personalizzati WebPartVerb all'insieme verbo per un WebPart controllo.

Si applica a

Vedi anche