WebPartVerb Sınıf

Tanım

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

Devralma

Object

WebPartVerb

Öznitelikler

TypeConverterAttribute

Uygulamalar

IStateManager

Örnekler

Aşağıdaki kod örneği, bir özel WebPartVerb nesnenin nasıl oluşturulacağını ve fiili bölgede yer alan her WebPart denetimin fiil menüsüne eklemek için yöntemini kullanan OnCreateVerbs bir özel bölgenin nasıl oluşturulacağını gösterir. Kod örneğinin dört bölümü vardır:

• Metin görüntüleyen basit bir özel WebPart denetim içeren kaynak dosya.

• Özel WebPartVerb bir nesne içeren kaynak dosya ve özel fiili WebPart bölgedeki denetimlere OnCreateVerbs eklemek için yöntemini geçersiz kılan basit WebPartZoneBase bir özel bölge.

• Özel bölgeyi ve özel denetimi içeren bir WebPart Web sayfası.

• Örneğin nasıl çalıştığını gösteren bir açıklama.

Kod örneğinin ilk bölümü, metin görüntüleyen basit WebPart bir denetim oluşturan kaynak kodu içerir. Kod örneğinin çalışması için bu kaynak kodu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin çalışma zamanında dinamik olarak derlenecek App_Code klasörüne yerleştirebilirsiniz. Bu kod örneği dinamik derleme yaklaşımını kullanır. Derlemeyi gösteren bir kılavuz için bkz. İzlenecek yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

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

Örneğin ikinci bölümü, özel bölgeyi ve WebPartVerb özel nesneyi oluşturmak için kaynak kodu içerir. Bölgenin, bölgedeki herhangi bir WebPart denetime özel fiili eklemek için yöntemini geçersiz kıldığını OnCreateVerbs unutmayın. Fiil, varsayılan olarak denetimlerin fiiller menüsüne eklenir. Özel fiilin kodunda, fiilin oluşturucusunun bir sunucu tıklama işleyicisi kullandığını ve adlı yöntemin doğrudan sınıfından WebPart devralan herhangi bir denetimin tam bir kopyasını oluşturduğunu ve yeni oluşturulan kopyayı aynı bölgeye eklediğini unutmayın. Kod örneğinin ilk bölümü gibi, bu kaynak kodun da derlenmiş olması gerekir ve bu örnekte kaynak dosya dinamik olarak derlenecek bir App_Code alt klasörüne yerleştirilmiştir.

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

Kod örneğinin üçüncü bölümü, denetimleri barındıran Web sayfasıdır. Özel denetimlerin ad alanını bildirmek için sayfanın üst kısmına yakın bir Register yönerge olduğunu unutmayın. Bu örnekte dinamik derleme kullanıldığı için derleme bildirilir. Özel WebPart denetim özel bölge içinde bildirilir. Bu bölgedeki diğer WebPart denetimleri de bildirebilirsiniz ve özel fiil de fiil menülerine eklenir.

<%@ 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>

Sayfayı bir tarayıcıda yükleyin ve özel WebPart denetimdeki fiiller menüsüne tıklayın. Web Bölümünü Kopyala fiili görünür olmalıdır. Fiili tıklatın ve denetimin bir kopyasının bölgeye eklendiğini unutmayın.

Açıklamalar

Web Bölümleri fiilleri, genellikle Web Bölümleri denetimlerini kullanan sayfalarda görünen düğmeler veya köprülerle temsil edilen etkileşimli kullanıcı arabirimi öğeleridir. Kullanıcılar, Web Bölümleri denetimleri için denetimi kapatma WebPart veya görüntüleme modunu düzenleme (denetimle ilişkilendirilmiş özel bir sayfa görünümü) kapatma gibi yaygın kullanıcı arabirimi eylemlerini gerçekleştirmek için fiillere EditorZone tıklar. Web Bölümleri denetim kümesiyle sağlanan tüm standart fiiller bir Web Bölümleri bölgesi (WebPartZone, EditorZone, CatalogZoneveya ) veya ConnectionsZoneWeb Bölümleri Part denetimi (WebPart, GenericWebPart, EditorPartveya CatalogPart) ile ilişkilendirilir.

Standart fiiller bir bölgeyle ilişkilendirildiğinde, eylemleri bölge düzeyinde uygulanır ve fiiller genellikle bölgenin üst bilgi veya alt bilgi alanında görünür. Aşağıdaki tabloda ortak bölge düzeyi fiiller listelenip eylemleri açıklanmaktadır.

Denetimlerle Part ilişkili standart fiillere gelince, eylemleri denetimin kendisine (veya alt denetimlerine) uygulanır. Parça denetimi fiil için bir kapsayıcı görevi görür ve fiilin işlenmesini yönetir. Parça denetimleriyle ilişkili çoğu standart fiil, doğrudan başlık çubuğunda veya başlık çubuğunun içindeki açılan fiiller menüsünde görünür. Bu fiillerin doğrudan üst bilgide mi yoksa fiil menüsünde mi görüneceği özelliği tarafından WebPartVerbRenderMode belirlenir; varsayılan olarak fiiller bir fiil menüsünde görünür. Aşağıdaki tabloda çeşitli Part denetimlerle ilişkili yaygın fiiller listelenip eylemleri açıklanmaktadır.

Web Bölümleri denetim kümesiyle birlikte sağlanan standart fiillerle birlikte özel fiiller de oluşturabilirsiniz. Özel fiiller oluşturmaya yönelik yaygın bir senaryo, denetimlerle Part ilişkili fiiller oluşturmaktır. Bu fiilleri oluşturduğunuzda, varsayılan olarak bunlar standart fiillerle birlikte fiiller menüsünde görünür. Bu tür fiiller oluşturmak için temel yaklaşım, bir veya daha fazla özel fiil oluşturmak için sınıfından WebPartVerb devralmaktır. Ardından temel sınıftan WebPart devralan bir denetim oluşturun ve özel WebPartVerb nesneleri bir WebPartVerbCollection koleksiyona ekleyin. Bu koleksiyon daha sonra denetimin Verbs koleksiyonuna eklenebilir ve bu da özel fiillerin çalışma zamanında denetimin fiiller menüsünde otomatik olarak görünmesine neden olur. Standart fiillerde olduğu gibi, özel fiillere bir WebPart denetimde program aracılığıyla erişebilirsiniz.

Web Bölümleri uygulamaları özel denetimler, kullanıcı denetimleri veya ASP.NET denetimleri gibi sınıftan WebPart devralmayan sunucu denetimlerini kullanabilir. Bu sunucu denetimleri, bir WebPartZoneBase bölgeye eklenirse çalışma zamanında bir GenericWebPart nesneyle dinamik olarak sarmalandığından, çalışma zamanı WebPart denetimleri olarak çalışmalarına olanak tanır. Sınıfından WebPart devralmayan bir sunucu denetimine özel fiiller eklemek için, sunucu denetiminin arabirimini IWebActionable uygulaması ve özelliğini geçersiz kılması Verbs gerekir.

Bir fiil oluşturduğunuzda, kullanıcı fiili tıklattığında çalışacak iki tür ilişkili olay işleyicisi oluşturabilirsiniz: sunucu tarafı olay işleyicisi (sunucuda çalışan kod) ve istemci tarafı olay işleyicisi (istemci tarayıcısında çalışan kod). Ayrıca, kullanıcılara görsel ipuçları sağlamanın kullanışlı bir yolu olan fiiller için özel durumlar tanımlayabilirsiniz. Örneğin, bir fiilin seçildiğini belirten bir durum oluşturabilir ve sonra kullanıcıya fiilin zaten seçili olduğunu bildirmek için kullanıcı arabiriminde uygun değişiklikler sağlayabilirsiniz. Başka bir yararlı davranış fiilleri devre dışı bırakma yeteneğidir; bunu yaparak, uygulamanın durumuna bağlı olarak kullanıcıların fiillere tıklamasını engelleyebilirsiniz.

WebPartVerb sınıfı herhangi bir benzersiz yöntemi kullanıma sunmaz; kullanıma sunulan yöntemlerin tümü temel yöntemlerin geçersiz kılmalarıdır. Ancak geliştiricilerin dikkate alınması gereken bir dizi özellik içerir. özelliği, Checked bir fiilin seçili olup olmadığını gösterir. ve ServerClickHandler özellikleri, ClientClickHandler istemci ve sunucu tıklama olayları için sınıfındaki ilgili işleyicilere (varsa) başvurur. özelliği, Description kullanıcılar kullanıcı arabirimindeki fiilin üzerine fare işaretçisi yerleştirdiğinde Araç İpucu'ndaki fiilin amacını açıklayan metin içerir. Enabled özelliği, bir fiilin geçerli durumunu gösterir. Bu durum, kullanıcının fiil tıklayıp eylemini yürütüp yürütemeyeceğini belirler. özelliği, ID fiil nesnesi için benzersiz bir kimlik sağlar. özelliği, ImageUrl varsayılan işleme yerine kullanıcı arabirimindeki bir fiili (genellikle bir düğme veya köprü) temsil etmek için kullanılabilecek bir görüntünün URL'sini içerir. özelliği, Text doğrudan kullanıcı arabirimindeki fiilde görünen etiket metnini içerir. Geçersiz kılınan Visible özellik, bir fiilin şu anda kullanıcı arabiriminde görüntülenip görüntülenmeyeceğini belirler. Fiiller genellikle bir Web Bölümleri uygulamasında farklı zamanlarda gizlenir veya devre dışı bırakılır; örneğin, özel fiiller (düzenleme fiilleri ve bağlantı fiilleri gibi), yalnızca bu fiillerin anlamlı bir eylem gerçekleştirmesini sağlamak için sayfada uygun denetimler, ayarlar ve görüntüleme modları mevcut olduğunda görüntülenir.

Fiillerle çalışmak için diğer önemli üyeler, fiil oluşturma işleminin WebPartZoneBase.OnCreateVerbs özel işlenmesi için geçersiz kılınabilecek bir olay işleyicisi olan yöntemi ve WebPartZoneBase.CreateVerbs olayı içerir.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• Verbs
• Verbs
• WebPartVerbCollection
• Web Bölümleri Denetimlerini ASP.NET