WebPartVerb.Text Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft die Textbezeichnung für ein Verb ab, das in der Benutzeroberfläche angezeigt wird, oder legt diese fest.

C#

public virtual string Text { get; set; }

Eigenschaftswert

String

Eine Zeichenfolge, die die Textbezeichnung für ein Verb enthält. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Das folgende Codebeispiel zeigt, wie die Text -Eigenschaft in einer abgeleiteten Klasse überschrieben wird, die von WebPartVerberbt. Dieser Quellcode zeigt nur den Teil des Codes für die benutzerdefinierte Zone und die Klasse an, die WebPartVerb die Eigenschaft außer Kraft setzt. Den restlichen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der WebPartVerb Klassenübersicht.

Nachdem Sie die Seite in einem Browser geladen haben, beachten Sie, dass der der Text Eigenschaft im Quellcode zugewiesene Wert im Verbenmenü des WebPart Steuerelements angezeigt wird.

C#

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 { ; }
    }
  }
}

Hinweise

Diese Eigenschaft legt den Text der Bezeichnung für ein Objekt fest WebPartVerb . Er stellt das Verb für Benutzer auf der Benutzeroberfläche dar.

Wenn Entwickler (optional) der ImageUrl -Eigenschaft einen Wert zuweisen, stellt ein Bild oder Symbol das Verb auf der Benutzeroberfläche dar, und in bestimmten Fällen (z. B. wenn das Verb normalerweise von einer Schaltfläche oder einem Link gerendert wird) wird das Bild anstelle der Textbeschriftung angezeigt.

Gilt für: