Freigeben über


WebPartVerb Klasse

Definition

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
WebPartVerb
Attribute
Implementiert

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 steuerelements in der Zone hinzuzufügen. Das Codebeispiel enthält vier Teile:

  • 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 zum Hinzufügen des benutzerdefinierten Verbs zu WebPart Steuerelementen in der Zone überschreibt.

  • 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 App_Code Ordner Ihrer Website ablegen, wo er zur Laufzeit dynamisch kompiliert wird. In diesem Codebeispiel wird der Ansatz der dynamischen Kompilierung 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 außer Kraft setzt, um das benutzerdefinierte Verb allen WebPart Steuerelementen in der Zone hinzuzufügen. Das Verb wird standardmäßig dem Verbenmenü der Steuerelemente hinzugefügt. Beachten Sie, dass der Konstruktor für das Verb im Code für das benutzerdefinierte Verb einen Serverklickhandler verwendet und dass die aufgerufene Methode eine vollständige Kopie eines steuerelements erstellt, das direkt von der WebPart -Klasse erbt und der gleichen Zone die neu erstellte Kopie hinzufügt. Wie der erste Teil des Codebeispiels muss dieser Quellcode kompiliert werden, und in diesem Beispiel wurde die Quelldatei in einem App_Code Unterordner platziert, um dynamisch kompiliert zu werden.

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, auf der die Steuerelemente gehostet werden. Beachten Sie, dass sich oben auf der Seite eine Register Anweisung befindet, um den Namespace der benutzerdefinierten Steuerelemente zu deklarieren. 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 einen Browser, und klicken Sie im benutzerdefinierten WebPart Steuerelement auf das Verbenmenü. 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

Webpartverben 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 Webpart-Steuerelemente auszuführen, z. B. das Schließen eines Steuerelements WebPart oder das Schließen des Bearbeitungsanzeigemodus (eine spezielle Seitenansicht, die dem EditorZone Steuerelement zugeordnet ist). Alle Standardverben, die mit dem Webpart-Steuerelementsatz bereitgestellt werden, sind entweder einer Webpartzone (WebPartZone, , CatalogZoneEditorZoneoder ConnectionsZone) oder einem Webpart-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 die normale Ansicht des Browsermodus zurück.
Verb anwenden Wird mit Zonen verwendet, die von der -Klasse erben EditorZoneBase . Wendet Änderungen an, die ein Benutzer vorgenommen hat.
Verb OK 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 Katalog von Steuerelementen ausgewählt hat.
Verb konfigurieren Wird mit Zonen verwendet, die von der -Klasse erben ConnectionsZone . Öffnet eine Ansicht, damit 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.

Bei den Standardverben, die Steuerelementen zugeordnet Part sind, gelten ihre Aktionen für das Steuerelement selbst (oder seine untergeordneten Steuerelemente). Das Teilsteuerelement 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.

Teilesteuerungsverb Aktion
Verb minimieren Wird im Verbenmenü jedes Serversteuerelements angezeigt, das in einer WebPartZoneBase Zone enthalten ist. Reduziert das Steuerelement auf eine minimale Darstellung, wodurch alles auf seiner Benutzeroberfläche mit Ausnahme des Wiederherstellungsverbens ausgeblendet wird.
Verb Wiederherstellen 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, was bedeutet, dass das Steuerelement von der Seite entfernt wird. Wenn jedoch ein ordnungsgemäß gestalteter 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 Verbindungsanzeigemodus befindet und ob das Steuerelement Verbindungen bilden kann. Öffnet eine Verbindungsoberfläche, sodass 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 programmgesteuert der Seite hinzugefügt wurde (anstatt im Persistenzformat deklariert zu werden). Löscht die Steuerelementinstanz und alle zugehörigen Personalisierungsdaten dauerhaft, sodass die gelöschte Instanz 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.
Exportverb 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.

Zusammen mit den Standardverben, die mit dem Webpart-Steuerelementsatz bereitgestellt werden, können Sie auch benutzerdefinierte Verben erstellen. Ein gängiges 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 für ein WebPart Steuerelement zugreifen.

Webpartanwendungen 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 seine 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 zu geben. Beispielsweise können Sie 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 unwirksam wäre.

Die WebPartVerb -Klasse macht keine eindeutigen Methoden verfügbar. Die verfügbar gemachten Methoden sind alle Überschreibungen von Basismethoden. Es enthält jedoch eine Reihe von Eigenschaften, auf die Entwickler achten 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 auf dem 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 Verbobjekt 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 einen Link). Die Text -Eigenschaft enthält den Bezeichnungstext, der direkt auf dem Verb auf der Benutzeroberfläche angezeigt wird. Die überschriebene Visible Eigenschaft bestimmt, ob ein Verb derzeit auf der Benutzeroberfläche angezeigt wird. Verben werden in einer Webpartanwendung häufig zu unterschiedlichen Zeitpunkten 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 zum Arbeiten 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:

Weitere Informationen