WebPart.Verbs Proprietà

Definizione

Ottiene un insieme di verbi personalizzati associati a un controllo WebPart.Gets a collection of custom verbs associated with a WebPart control.

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; }
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.A WebPartVerbCollection that contains custom WebPartVerb objects associated with a WebPart control. Il valore predefinito è Empty.The default value is Empty.

Implementazioni

Attributi

Esempi

Nell'esempio di codice seguente viene illustrato come accedere alla proprietà Verbs per un controllo Web part personalizzato.The following code example demonstrates how to access the Verbs property for a custom Web Parts control. Questo esempio presuppone l'uso di un controllo personalizzato, TextDisplayWebPart, creato nella sezione di esempio della panoramica della classe WebPart.This example assumes the use of a custom control, TextDisplayWebPart, created in the Example section of the WebPart class overview.

Si noti che per il corretto funzionamento dell'esempio di codice, è necessario aggiungere un'impostazione nel file Web. config per abilitare l'esportazione dei file di descrizione Web part.Note that for the code example to work, you must add a setting in the Web.config file to enable exporting Web Parts description files. Assicurarsi di disporre di un file Web. config nella stessa directory della pagina Web per questo esempio di codice.Ensure that you have a Web.config file in the same directory as the Web page for this code example. Nella sezione <system.web> verificare che sia presente un elemento <webParts> con un enableExport attributo impostato su true, come nel markup seguente.Within the <system.web> section, make sure there is a <webParts> element with an enableExport attribute set to true, as in the following markup.

<webParts enableExport="true">

...

</webParts>

Caricare la pagina Web in un browser.Load the Web page in a browser. Quando si fa clic sul pulsante Visualizza conteggio verbi , accede alla proprietà Verbs per ottenere il conteggio dei verbi personalizzati per il controllo TextDisplayWebPart e visualizza il conteggio in un'etichetta.When you click the Display Verb Count button, it accesses the Verbs property to get the count of custom verbs for the TextDisplayWebPart control, and displays the count in a label. Poiché in questo caso nessun verbo personalizzato è stato aggiunto al controllo, il conteggio è pari a zero.Because no custom verbs have been added to the control in this case, the count is 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 WebPartVerb e forniscono le azioni dell'interfaccia utente che gli utenti possono eseguire su un controllo WebPart.Verbs derive from the WebPartVerb class, and provide user interface (UI) actions that users can perform on a WebPart control. In genere i verbi sono rappresentati nell'interfaccia utente come pulsanti, collegamenti o voci di menu.Usually verbs are represented in the UI as buttons, links, or menu items. Per impostazione predefinita, i verbi di Web part comuni vengono visualizzati in un menu a discesa dei verbi nella barra del titolo di ogni controllo WebPart.By default, common Web Parts verbs appear on a drop-down verbs menu in each WebPart control's title bar. 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.There are standard verbs for opening, closing, editing, and minimizing a control, and other verbs for exporting a definition for the control or loading a Help file. Questi verbi non sono inclusi nella raccolta di Verbs, perché la raccolta contiene solo verbi personalizzati creati e restituiti eseguendo l'override di questa proprietà in una classe derivata.These verbs are not included in the Verbs collection, because the collection contains only custom verbs that you create and return by overriding this property in a derived class.

Quando si creano verbi personalizzati e li si aggiungono alla raccolta di Verbs, è possibile accedere ai verbi a livello di codice da un controllo WebPart.When you create custom verbs and add them to the Verbs collection, you can then access the verbs programmatically from a WebPart control.

Note per gli eredi

Le classi derivate possono eseguire l'override della proprietà Verbs per consentire agli utenti di aggiungere oggetti WebPartVerb personalizzati alla raccolta dei verbi per un controllo di WebPart.Derived classes can override the Verbs property to allow users to add custom WebPartVerb objects to the verb collection for a WebPart control.

Si applica a

Vedi anche