WebPart.Verbs Propriété
Définition
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.WebPartVerbCollectionPublic Overridable ReadOnly Property Verbs As WebPartVerbCollectionValeur 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.
