WebPart.Verbs Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Auflistung von benutzerdefinierten Verben ab, die einem WebPart Steuerelement zugeordnet sind.
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 WebPartVerbCollectionEigenschaftswert
Ein WebPartVerbCollection Objekt, das benutzerdefinierte WebPartVerb Objekte enthält, die einem WebPart Steuerelement zugeordnet sind. Der Standardwert ist Empty.
Implementiert
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie auf die Verbs Eigenschaft für ein benutzerdefiniertes Webpart-Steuerelement zugreifen. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas im Beispielabschnitt der WebPart Klassenübersicht erstellt wurde.
Beachten Sie, dass Sie für das Codebeispiel eine Einstellung in der datei Web.config hinzufügen müssen, um das Exportieren von Beschreibungsdateien für Webparts zu ermöglichen. Stellen Sie sicher, dass Sie über eine Web.config Datei im selben Verzeichnis wie die Webseite für dieses Codebeispiel verfügen.
<system.web> Stellen Sie im Abschnitt sicher, dass ein <webParts> Element mit einem enableExport Attribut vorhanden ist, das wie im folgenden Markup festgelegt trueist.
<webParts enableExport="true">
...
</webParts>
Laden Sie die Webseite in einem Browser. Wenn Sie auf die Schaltfläche " Verbanzahl anzeigen " klicken, greift sie auf die Verbs Eigenschaft zu, um die Anzahl der benutzerdefinierten Verben für das TextDisplayWebPart Steuerelement abzurufen und die Anzahl in einer Beschriftung anzuzeigen. Da dem Steuerelement in diesem Fall keine benutzerdefinierten Verben hinzugefügt wurden, ist die Anzahl null.
<%@ 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>
Hinweise
Verben leiten von der WebPartVerb Klasse ab und stellen Benutzeroberflächenaktionen bereit, die Benutzer auf einem WebPart Steuerelement ausführen können. In der Regel werden Verben in der Benutzeroberfläche als Schaltflächen, Links oder Menüelemente dargestellt. Standardmäßig werden allgemeine Webparts-Verben in einem Dropdown-Verbenmenü in der Titelleiste jedes WebPart Steuerelements angezeigt. Es gibt Standardverben zum Öffnen, Schließen, Bearbeiten und Minimieren eines Steuerelements sowie andere Verben zum Exportieren einer Definition für das Steuerelement oder Laden einer Hilfedatei. Diese Verben sind nicht in der Verbs Auflistung enthalten, da die Auflistung nur benutzerdefinierte Verben enthält, die Sie erstellen und zurückgeben, indem Sie diese Eigenschaft in einer abgeleiteten Klasse überschreiben.
Wenn Sie benutzerdefinierte Verben erstellen und der Sammlung hinzufügen Verbs , können Sie programmgesteuert über ein WebPart Steuerelement auf die Verben zugreifen.
Hinweise für Vererber
Abgeleitete Klassen können die Verbs Eigenschaft überschreiben, damit Benutzer der Verbauflistung für ein WebPart Steuerelement benutzerdefinierte WebPartVerb Objekte hinzufügen können.
