WebPart.Verbs Propriété

Définition

Obtient une collection de verbes personnalisés associée à un contrôle 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

Valeur de propriété

WebPartVerbCollection qui contient des objets WebPartVerb personnalisés associés à un contrôle WebPart. La valeur par défaut est Empty.

Implémente

Attributs

Exemples

L’exemple de code suivant montre comment accéder à la Verbs propriété d’un contrôle WebPart personnalisé. Cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPart, créé dans la section Exemple de la vue d’ensemble de la WebPart classe.

Notez que pour que l’exemple de code fonctionne, vous devez ajouter un paramètre dans le fichier Web.config pour permettre l’exportation des fichiers de description de composants WebPart. Vérifiez que vous disposez d’un fichier Web.config dans le même répertoire que la page Web pour cet exemple de code. Dans la <system.web> section , vérifiez qu’il existe un <webParts> élément avec un enableExport attribut défini sur true, comme dans le balisage suivant.

<webParts enableExport="true">

...

</webParts>

Chargez la page Web dans un navigateur. Lorsque vous cliquez sur le bouton Afficher le nombre de verbes , il accède à la Verbs propriété pour obtenir le nombre de verbes personnalisés pour le TextDisplayWebPart contrôle et affiche le nombre dans une étiquette. Étant donné qu’aucun verbe personnalisé n’a été ajouté au contrôle dans ce cas, le nombre est égal à zéro.

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

Remarques

Les verbes dérivent de la WebPartVerb classe et fournissent des actions d’interface utilisateur que les utilisateurs peuvent effectuer sur un WebPart contrôle. En règle générale, les verbes sont représentés dans l’interface utilisateur sous forme de boutons, de liens ou d’éléments de menu. Par défaut, les verbes de composants WebPart courants apparaissent dans un menu déroulant de verbes dans la barre de titre de chaque WebPart contrôle. Il existe des verbes standard pour ouvrir, fermer, modifier et réduire un contrôle, ainsi que d’autres verbes pour l’exportation d’une définition pour le contrôle ou le chargement d’un fichier d’aide. Ces verbes ne sont pas inclus dans la Verbs collection, car la collection contient uniquement les verbes personnalisés que vous créez et retournez en remplaçant cette propriété dans une classe dérivée.

Lorsque vous créez des verbes personnalisés et les ajoutez à la Verbs collection, vous pouvez ensuite accéder aux verbes par programmation à partir d’un WebPart contrôle.

Notes pour les héritiers

Les classes dérivées peuvent remplacer la Verbs propriété pour permettre aux utilisateurs d’ajouter des objets personnalisés WebPartVerb à la collection de verbes pour un WebPart contrôle.

S’applique à

Voir aussi