WebPart.Verbs Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, , TextDisplayWebPart
creato 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.