WebPartVerb Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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.

Stellt ein interaktives Element der Benutzeroberfläche bereit, mit dem Benutzer Aktionen auf einer Webparts-Seite ausführen können.

public ref class WebPartVerb : System::Web::UI::IStateManager

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))]
public class WebPartVerb : System.Web.UI.IStateManager

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))>]
type WebPartVerb = class
    interface IStateManager

Public Class WebPartVerb
Implements IStateManager

Vererbung: Object
WebPartVerb

Attribute: TypeConverterAttribute

Implementiert: IStateManager

Beispiele

Das folgende Codebeispiel zeigt, wie Sie ein benutzerdefiniertes WebPartVerb Objekt und eine benutzerdefinierte Zone erstellen, die die OnCreateVerbs -Methode verwendet, um das Verbenmenü jedes WebPart in der Zone enthaltenen Steuerelements hinzuzufügen. Das Codebeispiel besteht aus vier Teilen:

Eine Quelldatei, die ein einfaches benutzerdefiniertes WebPart Steuerelement enthält, das Text anzeigt.
Eine Quelldatei, die ein benutzerdefiniertes WebPartVerb Objekt enthält, und eine einfache benutzerdefinierte WebPartZoneBase Zone, die die OnCreateVerbs -Methode überschreibt, um WebPart steuerelemente in der Zone das benutzerdefinierte Verb hinzuzufügen.
Eine Webseite, die die benutzerdefinierte Zone und das benutzerdefinierte WebPart Steuerelement enthält.
Eine Erläuterung der Funktionsweise des Beispiels.

Der erste Teil des Codebeispiels enthält Quellcode, der ein einfaches WebPart Steuerelement erstellt, das Text anzeigt. Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren. Sie können sie explizit kompilieren und die resultierende Assembly im Ordner Bin ihrer Website oder im globalen Assemblycache ablegen. Alternativ können Sie den Quellcode im Ordner App_Code Ihrer Website ablegen, wo er zur Laufzeit dynamisch kompiliert wird. In diesem Codebeispiel wird der Dynamische Kompilierungsansatz verwendet. Eine exemplarische Vorgehensweise, die das Kompilieren veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{

    // This code snippet creates a simple Web Part control.
    [AspNetHostingPermission(SecurityAction.Demand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    public class SimpleControl : WebPart
    {

        private String _text = "Simple control text";

        public string Text
        {
            get
            {
                if (_text != null)
                    return _text;
                else
                    return string.Empty;
            }
            set { _text = value; }
        }

        protected override void Render(System.Web.UI.HtmlTextWriter 
      writer)
        {
            writer.Write(this.Text);
        }
    }
}

Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Collections.Generic
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code snippet creates a simple Web Part control.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class SimpleControl
    Inherits System.Web.UI.WebControls.WebParts.WebPart

    Private _text As String = "Simple control text"

    Public Property [Text]() As String
      Get
        If Not (_text Is Nothing) Then
          Return _text
        Else
          Return String.Empty
        End If
      End Get
      Set(ByVal value As String)
        _text = value
      End Set
    End Property

    Protected Overrides Sub Render(ByVal writer _
      As System.Web.UI.HtmlTextWriter)

      writer.Write(Me.Text)

    End Sub

  End Class

End Namespace

Der zweite Teil des Beispiels enthält Quellcode zum Erstellen der benutzerdefinierten Zone und des benutzerdefinierten WebPartVerb Objekts. Beachten Sie, dass die Zone die OnCreateVerbs -Methode überschreibt, um allen WebPart Steuerelementen in der Zone das benutzerdefinierte Verb hinzuzufügen. Das Verb wird standardmäßig dem Verbenmenü der Steuerelemente hinzugefügt. Beachten Sie, dass im Code für das benutzerdefinierte Verb der Konstruktor für das Verb einen Serverklickhandler verwendet und dass die aufgerufene Methode eine vollständige Kopie jedes Steuerelements erstellt, das direkt von der WebPart -Klasse erbt, wobei die neu erstellte Kopie der gleichen Zone hinzugefügt wird. Wie der erste Teil des Codebeispiels muss dieser Quellcode kompiliert werden, und in diesem Beispiel wurde die Quelldatei in einem App_Code Unterordner platziert, der dynamisch kompiliert werden soll.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
/* 
This code sample creates a Web Part zone and adds the 
"Copy Web Part" verb to any control in the zone.
*/
[AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
public class ZoneWithAddedVerb : WebPartZone
{

  protected override void OnCreateVerbs(WebPartVerbsEventArgs e)
  {
    List<WebPartVerb> newVerbs = new List<WebPartVerb>();
    newVerbs.Add(new CopyWebPartVerb(CopyWebPartToNewOne));
    e.Verbs = new WebPartVerbCollection(e.Verbs,newVerbs);
    base.OnCreateVerbs(e);
  }

  void CopyWebPartToNewOne(object sender, WebPartEventArgs e)
  {
    WebPartManager wpmgr = 
      WebPartManager.GetCurrentWebPartManager(Page);
    System.Web.UI.WebControls.WebParts.WebPart wp;
    Type tp = e.WebPart.GetType(); 
    wp = (System.Web.UI.WebControls.WebParts.WebPart)Activator.CreateInstance(tp);   
    wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1);
  }
}
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  internal class CopyWebPartVerb : WebPartVerb
  {
    private const String _copyWebPartImageUrl = "~/CopyVerb.ico";

    internal CopyWebPartVerb(WebPartEventHandler serverClickHandler) :  
       base("MyVerb", serverClickHandler)
    { }
    public override string Text
    {
      get { return "Copy Web Part"; }
      set { ;}
    }
    public override string Description
    {
      get { return "This verb will copy this web part control " +
        "to a new one below"; }
      set { ; }
    }
    public override bool Enabled
    {
      get { return base.Enabled; }
      set { base.Enabled = value; }
    }
    
    public override string ImageUrl
    {
      get { return _copyWebPartImageUrl; }
      set { ; }
    }
  }
}

Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Collections.Generic
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code sample creates a Web Part zone and adds the 
' "Copy Web Part" verb to any control in the zone.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZoneWithAddedVerb
    Inherits WebPartZone

    'public class ExtendedWebPartZoneBase 
    Protected Overrides Sub OnCreateVerbs(ByVal e _
      As WebPartVerbsEventArgs)

      Dim newVerbs As List(Of WebPartVerb) = _
        New List(Of WebPartVerb)
      newVerbs.Add(New CopyWebPartVerb(AddressOf CopyWebPartToNewOne))
      e.Verbs = New WebPartVerbCollection(e.Verbs, newVerbs)
      MyBase.OnCreateVerbs(e)

    End Sub


    Sub CopyWebPartToNewOne(ByVal sender As Object, _
      ByVal e As WebPartEventArgs)

      Dim wpmgr As WebPartManager = _
        WebPartManager.GetCurrentWebPartManager(Page)
      Dim wp As System.Web.UI.WebControls.WebParts.WebPart
      Dim tp As Type = e.WebPart.GetType()
      wp = CType(Activator.CreateInstance(tp), _
        System.Web.UI.WebControls.WebParts.WebPart)
      wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Friend Class CopyWebPartVerb
    Inherits WebPartVerb
    Private Const _copyWebPartImageUrl As String = "~/CopyVerb.ico"

    Friend Sub New(ByVal serverClickHandler As WebPartEventHandler)
      MyBase.New("MyVerb", serverClickHandler)

    End Sub

    Public Overrides Property [Text]() As String
      Get
        Return "Copy Web Part"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Description() As String
      Get
        Return "This verb will copy this web part control to a " _
               & "new one below"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Enabled() As Boolean
      Get
        Return MyBase.Enabled
      End Get
      Set(ByVal value As Boolean)
        MyBase.Enabled = value
      End Set
    End Property
    
    Public Overrides Property ImageUrl() As String
      Get
        Return Me._copyWebPartImageUrl
      End Get
      Set(ByVal value As String)
      End Set
    End Property

  End Class

End Namespace

Der dritte Teil des Codebeispiels ist die Webseite, die die Steuerelemente hostet. Beachten Sie, dass oben auf der Seite eine Register Direktive zum Deklarieren des Namespace der benutzerdefinierten Steuerelemente vorhanden ist. Es wird keine Assembly deklariert, da in diesem Beispiel die dynamische Kompilierung verwendet wird. Das benutzerdefinierte WebPart Steuerelement wird innerhalb der benutzerdefinierten Zone deklariert. Sie können auch andere WebPart Steuerelemente in dieser Zone deklarieren, und das benutzerdefinierte Verb wird auch ihren Verbenmenüs hinzugefügt.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="verbsample" 
    namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register TagPrefix="verbsample" 
    namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>

Laden Sie die Seite in einem Browser, und klicken Sie im benutzerdefinierten WebPart Steuerelement auf das Menü Verben. Das Verb "Webpart kopieren " sollte sichtbar sein. Klicken Sie auf das Verb, und beachten Sie, dass der Zone eine Kopie des Steuerelements hinzugefügt wird.

Hinweise

Webpartsverben sind interaktive Benutzeroberflächenelemente, die in der Regel durch Schaltflächen oder Hyperlinks dargestellt werden und auf Seiten angezeigt werden, die Webparts-Steuerelemente verwenden. Benutzer klicken auf Verben, um allgemeine Ui-Aktionen für Webparts-Steuerelemente auszuführen, z. B. das Schließen eines WebPart Steuerelements oder das Schließen des Bearbeitungsanzeigemodus (eine spezielle Seitenansicht, die dem EditorZone Steuerelement zugeordnet ist). Alle Standardverben, die mit dem Webparts-Steuerelementsatz bereitgestellt werden, sind entweder einer Webpartszone (WebPartZone, , CatalogZone EditorZoneoder ConnectionsZone) oder einem Webparts-Steuerelement Part (WebPart, , GenericWebPart EditorPartoder CatalogPart) zugeordnet.

Wenn die Standardverben einer Zone zugeordnet sind, gelten ihre Aktionen auf Zonenebene, und die Verben werden normalerweise im Kopf- oder Fußzeilenbereich der Zone angezeigt. In der folgenden Tabelle sind die allgemeinen Verben auf Zonenebene aufgeführt und ihre Aktionen beschrieben.

Verb auf Zonenebene	Aktion
Verb schließen	Wird mit Zonen verwendet, die von der -Klasse erben ToolZone . Blendet die Benutzeroberfläche für eine Zone aus und gibt die Seite in der Regel in ihre normale Ansicht im Browsermodus zurück.
Verb anwenden	Wird mit Zonen verwendet, die von der -Klasse erben EditorZoneBase . Wendet Änderungen an, die ein Benutzer vorgenommen hat.
OK-Verb	Wird mit Zonen verwendet, die von der -Klasse erben EditorZoneBase . Hat die kombinierte Wirkung der Anwenden- und Schließen-Verben; Es wendet Änderungen an und blendet die Benutzeroberfläche der Zone aus.
Verb abbrechen	Wird mit Zonen verwendet, die von der -Klasse erben ToolZone . Bricht alle ausstehenden Änderungen ab, die ein Benutzer vorgenommen hat.
Verb hinzufügen	Wird mit Zonen verwendet, die von der -Klasse erben CatalogZoneBase . Fügt einer angegebenen WebPartZone Zone ein Steuerelement hinzu, das ein Benutzer aus einem Steuerelementkatalog ausgewählt hat.
Konfigurieren des Verbs	Wird mit Zonen verwendet, die von der -Klasse erben ConnectionsZone . Öffnet eine Ansicht, mit der Benutzer vorhandene Verbindungen konfigurieren können.
Verb trennen	Wird mit Zonen verwendet, die von der -Klasse erben ConnectionsZone . Beendet eine vorhandene Verbindung zwischen zwei Steuerelementen.

Was die Standardverben betrifft, die Steuerelementen zugeordnet Part sind, gelten ihre Aktionen für das Steuerelement selbst (oder seine untergeordneten Steuerelemente). Das Part-Steuerelement fungiert als Container für das Verb und verwaltet das Rendering des Verbs. Die meisten Standardverben, die Teilsteuerelementen zugeordnet sind, werden entweder direkt in der Titelleiste oder in einem Dropdownmenü für Verben in der Titelleiste angezeigt. Ob diese Verben direkt in der Kopfzeile oder in einem Verbenmenü angezeigt werden, wird durch die WebPartVerbRenderMode -Eigenschaft bestimmt. Standardmäßig werden die Verben in einem Verbenmenü angezeigt. In der folgenden Tabelle sind allgemeine Verben aufgeführt, die den verschiedenen Part Steuerelementen zugeordnet sind, und ihre Aktionen werden beschrieben.

Verb "Part control" (Teilsteuerelement)	Aktion
Verb minimieren	Wird im Verbenmenü jedes Serversteuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist. Reduziert das Steuerelement auf eine minimale Darstellung und blendet alles in seiner Benutzeroberfläche aus, mit Ausnahme des Wiederherstellungsverbs.
Wiederherstellen des Verbs	Wird im Verbenmenü jedes Serversteuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist. Gibt ein minimiertes Steuerelement auf seine normale Größe und Ansicht zurück.
Verb schließen	Wird im Verbenmenü jedes Serversteuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist. Schließt ein Steuerelement und fügt es dem Seitenkatalog hinzu. Dies bedeutet, dass das Steuerelement von der Seite entfernt wird. Wenn jedoch ein ordnungsgemäß entworfener Katalog vorhanden ist, können Benutzer das geschlossene Steuerelement erneut öffnen und auf die Seite zurückgeben.
Verb verbinden	Wird im Verbenmenü eines Steuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist, wenn sich die Seite im Anzeigemodus "Verbindung" befindet und das Steuerelement Verbindungen bilden kann. Öffnet eine Verbindungsoberfläche, damit Benutzer eine Verbindung zwischen Steuerelementen erstellen können.
Verb löschen	Wird im Verbenmenü eines Steuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist, wenn das Steuerelement der Seite programmgesteuert hinzugefügt wurde (anstatt im Persistenzformat deklariert zu werden). Löscht das Steuerelement instance und alle zugehörigen Personalisierungsdaten dauerhaft, sodass die gelöschte instance im Gegensatz zu einem geschlossenen Steuerelement nie auf der Seite wiederhergestellt werden kann.
Verb bearbeiten	Wird im Verbenmenü eines Steuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist, wenn die Seite die Bearbeitung von Steuerelementen ermöglicht und sich die Seite im Bearbeitungsanzeigemodus befindet. Wählt das Steuerelement für die Bearbeitung aus und öffnet die Bearbeitungsoberfläche.
Exportieren des Verbs	Wird im Verbenmenü eines Steuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist, wenn das Steuerelement und die Anwendung für den Export aktiviert sind. Öffnet ein Dialogfeld, in dem Benutzer eine Beschreibungsdatei exportieren können, die den serialisierten Zustand des Steuerelements enthält. Ausführliche Informationen finden Sie unter der ExportMode-Eigenschaft.
Hilfeverb	Wird im Verbenmenü eines Steuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist, wenn das Steuerelement für die Bereitstellung einer Hilfedatei konzipiert ist. Startet eine Seite, die Hilfe für das Steuerelement bereitstellt.

Neben den Standardverben, die mit dem Webparts-Steuerelementsatz bereitgestellt werden, können Sie auch benutzerdefinierte Verben erstellen. Ein häufiges Szenario zum Erstellen benutzerdefinierter Verben ist das Erstellen von Verben, die Steuerelementen zugeordnet sind Part . Wenn Sie diese Verben erstellen, werden sie standardmäßig zusammen mit den Standardverben im Verbenmenü angezeigt. Der grundlegende Ansatz zum Erstellen solcher Verben besteht darin, von der WebPartVerb -Klasse zu erben, um ein oder mehrere benutzerdefinierte Verben zu erstellen. Erstellen Sie dann ein Steuerelement, das von der WebPart Basisklasse erbt, und fügen Sie die benutzerdefinierten WebPartVerb Objekte einer WebPartVerbCollection Auflistung hinzu. Diese Auflistung kann dann der Verbs Auflistung des Steuerelements hinzugefügt werden, wodurch die benutzerdefinierten Verben zur Laufzeit automatisch im Verbenmenü des Steuerelements angezeigt werden. Wie bei den Standardverben können Sie programmgesteuert auf die benutzerdefinierten Verben in einem WebPart Steuerelement zugreifen.

Webpartsanwendungen können Serversteuerelemente verwenden, die nicht von der WebPart -Klasse erben, z. B. benutzerdefinierte Steuerelemente, Benutzersteuerelemente oder ASP.NET-Steuerelemente. Diese Serversteuerelemente werden, wenn sie einer WebPartZoneBase Zone hinzugefügt werden, zur Laufzeit dynamisch mit einem GenericWebPart -Objekt umschlossen, sodass sie als Laufzeitsteuerelemente WebPart fungieren können. Um einem Serversteuerelement, das nicht von der WebPart -Klasse erbt, benutzerdefinierte Verben hinzuzufügen, muss das Serversteuerelement die IWebActionable -Schnittstelle implementieren und die Verbs -Eigenschaft überschreiben.

Wenn Sie ein Verb erstellen, können Sie zwei Typen von zugeordneten Ereignishandlern erstellen, die ausgeführt werden, wenn ein Benutzer auf das Verb klickt: einen serverseitigen Ereignishandler (Code, der auf dem Server ausgeführt wird) und einen clientseitigen Ereignishandler (Code, der im Clientbrowser ausgeführt wird). Außerdem können Sie benutzerdefinierte Zustände für Verben definieren, was eine nützliche Möglichkeit ist, Benutzern visuelle Hinweise bereitzustellen. Sie können beispielsweise einen Zustand erstellen, der angibt, dass ein Verb ausgewählt wurde, und dann entsprechende Änderungen auf der Benutzeroberfläche bereitstellen, um den Benutzer darüber zu informieren, dass das Verb bereits ausgewählt ist. Ein weiteres nützliches Verhalten ist die Möglichkeit, Verben zu deaktivieren. Auf diese Weise können Sie verhindern, dass Benutzer auf Verben klicken, wenn dies basierend auf dem Status der Anwendung schädlich oder ineffektiv wäre.

Die WebPartVerb -Klasse macht keine eindeutigen Methoden verfügbar. Die verfügbar gemachten Methoden sind alle Außerkraftsetzungen von Basismethoden. Es enthält jedoch eine Reihe von Eigenschaften, die Entwickler beachten sollten. Die Checked -Eigenschaft gibt an, ob derzeit ein Verb ausgewählt ist. Die ClientClickHandler Eigenschaften und ServerClickHandler verweisen auf die entsprechenden Handler innerhalb der -Klasse (sofern vorhanden) für Client- und Serverklickereignisse. Die Description -Eigenschaft enthält Text, der den Zweck eines Verbs in einer QuickInfo beschreibt, wenn Benutzer einen Mauszeiger über das Verb in der Benutzeroberfläche positionieren. Die Enabled -Eigenschaft gibt den aktuellen status eines Verbs an, der bestimmt, ob ein Benutzer auf das Verb klicken und seine Aktion ausführen kann. Die ID -Eigenschaft stellt eine eindeutige ID für das Verb-Objekt bereit. Die ImageUrl -Eigenschaft enthält eine URL zu einem Bild, das verwendet werden kann, um ein Verb auf der Benutzeroberfläche anstelle des Standardrenderings darzustellen (in der Regel eine Schaltfläche oder ein Link). Die Text -Eigenschaft enthält den Bezeichnungstext, der direkt auf dem Verb in der Benutzeroberfläche angezeigt wird. Die überschriebene Visible Eigenschaft bestimmt, ob ein Verb derzeit auf der Benutzeroberfläche angezeigt wird. Verben werden in einer Webparts-Anwendung häufig zu unterschiedlichen Zeiten ausgeblendet oder deaktiviert. Beispielsweise werden Spezialverben (z. B. das Bearbeitungsverb und das Verbindungsverb) nur angezeigt, wenn die entsprechenden Steuerelemente, Einstellungen und Anzeigemodi auf der Seite vorhanden sind, damit diese Verben sinnvolle Aktionen ausführen können.

Weitere wichtige Member für die Arbeit mit Verben sind die -Methode, bei der WebPartZoneBase.OnCreateVerbs es sich um einen Ereignishandler handelt, der für die benutzerdefinierte Behandlung des Verberstellungsprozesses überschrieben werden kann, und das WebPartZoneBase.CreateVerbs -Ereignis.

Konstruktoren

WebPartVerb(String, String)	Initialisiert eine neue Instanz der WebPartVerb-Klasse und ordnet der Instanz einen clientseitigen Click-Ereignishandler zu.
WebPartVerb(String, WebPartEventHandler)	Initialisiert eine neue Instanz der WebPartVerb-Klasse und ordnet der Instanz einen serverseitigen Click-Ereignishandler zu.
WebPartVerb(String, WebPartEventHandler, String)	Initialisiert eine neue Instanz der WebPartVerb-Klasse und ordnet der Instanz sowohl einen clientseitigen als auch einen serverseitigen Click-Ereignishandler zu.

Eigenschaften

Checked	Ruft einen Wert ab, der angibt, dass ein einem benutzerdefinierten Verb zugeordneter Zustand derzeit aktiv oder ausgewählt ist, oder legt diesen fest.
ClientClickHandler	Ruft die Zeichenfolge ab, die den Methodennamen des clientseitigen Ereignishandlers enthält, der im WebPartVerb-Konstruktor definiert ist.
Description	Ruft eine Kurzbeschreibung des Verbs ab oder legt diese fest.
Enabled	Ruft einen Wert ab, der angibt, ob ein Verb aktiviert ist, oder legt diesen fest.
ID	Ruft eine Zeichenfolge ab, die eine eindeutige ID für ein Verb enthält.
ImageUrl	Ruft eine Zeichenfolge ab, die die URL eines Bilds enthält, das ein Verb in der Benutzeroberfläche darstellt, oder legt diese fest.
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für ein Verb derzeit verfolgt wird.
ServerClickHandler	Ruft einen Verweis auf die Methode ab, die serverseitige Click-Ereignisse für das Verb behandelt.
Text	Ruft die Textbezeichnung für ein Verb ab, das in der Benutzeroberfläche angezeigt wird, oder legt diese fest.
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.
Visible	Ruft einen Wert ab, der angibt, ob ein Verb für Benutzer sichtbar ist, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SaveViewState()	Speichert die Änderungen am Ansichtszustand eines WebPartVerb-Objekts, die seit dem letzten Zurücksenden der Seite an den Server aufgetreten sind.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Verfolgt Änderungen am Ansichtszustand eines Verbs, sodass diese Änderungen im StateBag-Objekt des Verbs gespeichert werden können.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Implementiert die IsTrackingViewState-Eigenschaft, indem die WebPartVerb-Eigenschaft der IsTrackingViewState-Klasse aufgerufen wird.
IStateManager.LoadViewState(Object)	Implementiert die LoadViewState(Object)-Methode der IStateManager-Schnittstelle, indem die WebPartVerb-Methode der LoadViewState(Object)-Klasse aufgerufen wird.
IStateManager.SaveViewState()	Implementiert die SaveViewState()-Methode, indem die WebPartVerb-Methode der SaveViewState()-Klasse aufgerufen wird.
IStateManager.TrackViewState()	Implementiert die TrackViewState()-Methode, indem die WebPartVerb-Methode der TrackViewState()-Klasse aufgerufen wird.

Gilt für: