WebPart.Verbs Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

Implémente

Verbs

Attributs: BrowsableAttribute

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 activer l’exportation des fichiers de description de composants WebPart. Assurez-vous 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 élément avec un <webParts>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. Généralement, 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 s’affichent 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 permettant d’exporter une définition pour le contrôle ou de charger un fichier d’aide. Ces verbes ne sont pas inclus dans la Verbs collection, car la collection contient uniquement des 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 que vous 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 d’un WebPart contrôle.

S’applique à