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 benutzerdefinierter 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
Eine WebPartVerbCollection mit benutzerdefinierten WebPartVerb-Objekten, die einem WebPart-Steuerelement zugeordnet sind. Der Standardwert ist Empty.
Implementiert
- Attribute
Beispiele
Im folgenden Codebeispiel wird der Zugriff auf die Verbs Eigenschaft für ein benutzerdefiniertes Webpart-Steuerelement veranschaulicht. In diesem Beispiel wird von der Verwendung eines benutzerdefinierten Steuerelements ausgegangen, TextDisplayWebPartdas im Abschnitt Beispiel der WebPart Klassenübersicht erstellt wurde.
Beachten Sie, dass Sie in der Web.config-Datei eine Einstellung hinzufügen müssen, damit das Codebeispiel funktioniert, um den Export von Webparts-Beschreibungsdateien zu ermöglichen. Stellen Sie sicher, dass Sich eine Web.config Datei im selben Verzeichnis wie die Webseite für dieses Codebeispiel befindet.
<system.web> Stellen Sie im Abschnitt sicher, dass ein Element mit einem enableExport Attribut auf truefestgelegt ist<webParts>, wie im folgenden Markup.
<webParts enableExport="true">
...
</webParts>
Laden Sie die Webseite in einen 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 zeigt die Anzahl in einer Bezeichnung an. Da dem Steuerelement in diesem Fall keine benutzerdefinierten Verben hinzugefügt wurden, ist die Anzahl 0.
<%@ 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 stammen von der WebPartVerb -Klasse ab und stellen Aktionen der Benutzeroberfläche bereit, die Benutzer für ein 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 gängige Webparts-Verben in einem Dropdownmenü 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 Verbs Auflistung hinzufügen, 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.
