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, , TextDisplayWebPartcreato 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 abilitare l'esportazione dei 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 assicurarsi 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 verbo, accede Verbs alla proprietà per ottenere il conteggio dei verbi personalizzati per il TextDisplayWebPart controllo e visualizza il conteggio in un'etichetta. Poiché non sono stati aggiunti verbi personalizzati al controllo 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 classe e forniscono azioni dell'interfaccia WebPartVerb 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 comuni delle Web part vengono visualizzati in un menu a discesa nella barra del titolo di ogni WebPart controllo. Esistono 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 contiene solo verbi personalizzati creati e restituiti eseguendo l'override Verbs di questa proprietà in una classe derivata.

Quando si creano verbi personalizzati e li si aggiunge alla Verbs raccolta, è quindi 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