This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

WebPartVerb الفئة

Visual Studio 2010

يوفر عنصر واجهة مستخدم الحالي الذي يمكن المستخدمين من إلى تنفيذ الاجراءات تشغيل صفحة "أجزاء ويب".

مساحة الاسم:  System.Web.UI.WebControls.WebParts
التجميع:  System.Web (في System.Web.dll)

public class WebPartVerb : IStateManager

تكون الأفعال أجزاء ويب لعناصر واجهة المستخدم التفاعلي، عادة ما يمثله الأزرار أو الارتباطات التشعبية، والتي تظهر في الصفحات التي تستخدم "أجزاء ويب" عناصر التحكم. أفعال لتنفيذ الإجراءات عام لواجهة المستخدم عن "أجزاء ويب" للمستخدمين النقر فوق عناصر التحكم، مثل إغلاق WebPartعنصر التحكم أو إغلاق الوضع عرض التحرير (المقترنة بعرض صفحة خاص EditorZoneعنصر التحكم). الجميع قياسي الأفعال provided مع the عنصر تحكم أجزاء ويب التعيين are associated مع either a Web Parts منطقة (WebPartZone, EditorZone, CatalogZone, أو ConnectionsZone) أو a Web Parts Part control (WebPart, GenericWebPart, EditorPart, أو CatalogPart).

When the قياسي الأفعال are associated مع a منطقة, their الاجراءات يطبق at the منطقة المستوى, و the الأفعال usually appear في the منطقة's عنوان أو تذييل الصفحة مساحة. The following جدول lists the عام منطقة-المستوى الأفعال و describes their الاجراءات.

منطقة-المستوى فعل

Action

يغلق فعل

Used مع zones that يورث من the ToolZone فئة. Hides the واجه المستخدم for a منطقة و typically إرجاع the الصفحة إلى its عادي استعراض الوضع عرض.

يطبق فعل

Used مع zones that يورث من the EditorZoneBase فئة. Applies التغييرات that a مستخدم has made.

‏‏موافق فعل

Used مع zones that يورث من the EditorZoneBase فئة. Has the combined effect of the يطبق و يغلق الأفعال; it applies التغييرات و hides the منطقة's واجه المستخدم.

إلغاء الأمر فعل

Used مع zones that يورث من the ToolZone فئة. Cancels أي معلّقة التغييرات a مستخدم has made.

إضافة فعل

Used مع zones that يورث من the CatalogZoneBase فئة. Adds a عنصر تحكم that a مستخدم has محدد من a كاتالوج of عناصر التحكم إلى a specified WebPartZone منطقة.

تكوين فعل

Used مع zones that يورث من the ConnectionsZone فئة. Opens a عرض إلى تمكين users إلى تكوين موجود الاتصالات.

قطع الاتصال فعل

Used مع zones that يورث من the ConnectionsZone فئة. Terminates an موجود اتصال between الثاني عناصر التحكم.

كـ for the قياسي الأفعال that are associated مع Part عناصر التحكم, their الاجراءات يطبق على the عنصر تحكم itself (أو إلى its فرع عناصر التحكم). The عنصر تحكم الجزء acts كـ a حاوية for the فعل و manages the رسم هندسي of the فعل. تظهر الأفعال القياسية الأكثر المرفقة بعناصر جزء أما مباشرة في شريط العنوان أو في قائمة منسدلة قائمة الأفعال ضمن شريط العنوان. هذه الأفعال تظهر مباشرة في الرأس أو في قائمة الأفعال يتحدد بواسطة WebPartVerbRenderModeالخاصية؛ بشكل افتراضي، تظهر الأفعال في قائمة الأفعال. The following جدول lists عام الأفعال associated مع the متنوع Part عناصر التحكم و describes their الاجراءات.

عنصر تحكم الجزء فعل

Action

تصغير فعل

Appears في the الأفعال قائمة of each عنصر تحكم الخادم contained في a WebPartZoneBase منطقة. Reduces the عنصر تحكم إلى a الأدنى representation, hiding everything في its واجه المستخدم except the استعادة فعل.

استعادة فعل

Appears في the الأفعال قائمة of each عنصر تحكم الخادم contained في a WebPartZoneBase منطقة. إرجاع a minimized عنصر تحكم إلى its عادي الحجم و عرض.

يغلق فعل

Appears في the الأفعال قائمة of each عنصر تحكم الخادم contained في a WebPartZoneBase منطقة. Closes a عنصر تحكم و adds it إلى the الصفحة كاتالوج, which means the عنصر تحكم هو تمت إزالته من the الصفحة but, if there هو a properly designed كاتالوج, users can reopen the مغلق عنصر تحكم و return it إلى the الصفحة.

يعيّن فعل

يظهر في قائمة الأفعال عنصر تحكم في WebPartZoneBaseمنطقة، وإذا الصفحة هو في الوضع عرض الاتصال عنصر تحكم يمكن تكوين اتصالات فتح اتصال واجهة المستخدم بحيث يمكن للمستخدمين إنشاء اتصال بين عناصر التحكم.

قم بحذف فعل

يظهر في قائمة الأفعال عنصر تحكم في WebPartZoneBaseمنطقة، وإذا كان عنصر تحكم تمت إضافته إلى الصفحة برمجياً (بدلاً من يتم التصريح بتنسيق الاستمرارية). Permanently deletes the عنصر تحكم مثيل و أي associated إضفاء طابع شخصي بيانات so that, unlike a مغلق عنصر تحكم, the تم الحذف مثيل can ‏‏مطلقاً be restored إلى the الصفحة.

تحرير فعل

Appears في the الأفعال قائمة of a عنصر تحكم contaفيed في a WebPartZoneBase منطقة, if the page هو designed إلى permit تحريرفيg of عناصر التحكم و if the page هو في ‏‏تحرير الوضع عرض. Selects the عنصر تحكم for ‏‏تحرير و opens the ‏‏تحرير واجه المستخدم.

يصدّر فعل

يظهر في قائمة الأفعال عنصر تحكم في WebPartZoneBaseمنطقة، وإذا كان عنصر تحكم والتطبيقات الممكنة للتصدير. Opens a حوار صندوق that enables users إلى يصدّر a وصف ملف that يحتوي على the serialized الولاية of the عنصر تحكم. للحصول على تفاصيل، راجع ExportModeالخاصية.

تعليمات فعل

يظهر في قائمة الأفعال عنصر تحكم في WebPartZoneBaseمنطقة، وإذا كان عنصر تحكم مصممة لتوفير ملفات التعليمات. Launches a الصفحة that provides تعليمات for the عنصر تحكم.

Along مع the قياسي الأفعال that are provided مع the عنصر تحكم أجزاء ويب التعيين, you can also إنشاء مخصص الأفعال. A عام السيناريو for creating مخصص الأفعال هو إلى إنشاء الأفعال associated مع Part عناصر التحكم. When you إنشاء these الأفعال, بواسطة الافتراضي they will appear تشغيل the الأفعال قائمة along مع the قياسي الأفعال. The أساسى approach for creating such الأفعال هو إلى يورث من the WebPartVerb فئة إلى إنشاء واحد أو المزيد مخصص الأفعال. Then إنشاء a عنصر تحكم that inherits من the WebPart فئة الأساس و إضافة the مخصص WebPartVerb الكائنات إلى a WebPartVerbCollection مجموعة. هذه المجموعة يمكن إضافتها إلى Verbsمجموعة من عناصر التحكم، والذي يؤدي مخصص الأفعال يظهر تلقائياً في قائمة الأفعال الخاصة بعنصر التحكم في تشغيل الوقت. كـ مع the قياسي الأفعال, you can الوصول the مخصص الأفعال programmatically تشغيل a WebPart عنصر تحكم.

أجزاء ويب يمكن للتطبيقات استخدام عناصر تحكم الملقم لا يورث من WebPartالفئة، مثل عناصر التحكم المخصصة أو عناصر تحكم المستخدم، أو عناصر تحكم ASP.NET. These الخادم عناصر التحكم, if تمت الإضافة إلى a WebPartZoneBase منطقة, are dynamically wrapped مع a GenericWebPart كائن at تشغيل الوقت, which enables them إلى دالة كـ تشغيل-الوقت WebPart عناصر التحكم. إلى إضافة مخصص الأفعال إلى a عنصر تحكم الخادم that does not يورث من the WebPart فئة, the عنصر تحكم الخادم must implement the IWebActionable واجهة و يمنع its Verbs خاصية.

When you إنشاء a فعل, you can إنشاء الثاني أنواع of associated حدث handlers that will تشغيل when a مستخدم clicks the فعل: a الخادم-side معالج الأحداث (تعليمات برمجية that runs تشغيل the الخادم), و a العميل-side معالج الأحداث (تعليمات برمجية that runs في the العميل مستعرض). Also, you can define مخصص states for الأفعال, which هو a useful way إلى provide visual cues إلى users. For مثال, you could إنشاء a الولاية indicating that a فعل has been محدد, و then provide appropriate التغييرات في the واجه المستخدم إلى notify the مستخدم that the فعل هو already محدد. Another useful سلوك هو the ability إلى يعطل الأفعال; بواسطة doing this, you can prevent users من clicking الأفعال if doing so would be harmful أو ineffective based تشغيل the الولاية of the تطبيق.

The WebPartVerb فئة does not expose أي فريد وظائف; its exposed وظائف are الجميع overrides of الأساس وظائف. It does however contain a رقم of خصائص for developers إلى be aware of. The Checked خاصية indicates whether a فعل هو currently محدد. The ClientClickHandler و ServerClickHandler خصائص refer إلى the respective handlers within the فئة (if أي exist) for العميل و الخادم انقر أحداث. The Description خاصية يحتوي على نص that describes the purpose of a فعل في a ‏‏تلميح الأداة when users موضع a ماوس مؤشر over the فعل في the واجه المستخدم. The Enabled خاصية indicates the الحالي حالة of a فعل, which determines whether a مستخدم can انقر the فعل و ينفذ its إجراء. The ID خاصية provides a فريد المعرف for the فعل كائن. The ImageUrl خاصية يحتوي على a URL إلى an نسخة that can be used إلى represent a فعل في the واجه المستخدم في place of the الافتراضي رسم هندسي (typically a زر أو a رابط). The Text خاصية يحتوي على the التسمية نص that appears directly تشغيل the فعل في the واجه المستخدم. The overridden Visible خاصية determines whether a فعل هو currently displayed في the واجه المستخدم. الأفعال are often مخفي أو معطّل at different مرة/مرات في a ويب Parts تطبيق; for مثال, specialty الأفعال (such كـ the تحرير فعل و the يعيّن فعل) are displayed فقط when the appropriate عناصر التحكم, إعدادات, و عرض modes exist تشغيل the الصفحة إلى تمكين those الأفعال إلى take meaningful إجراء.

تضمين الأعضاء الآخرين المفاتيح للعمل مع أفعال WebPartZoneBase.OnCreateVerbsالأسلوب، الذي هو معالج أحداث الذي يمكن تجاوزها لمعالجة مخصصة لعملية إنشاء فعل، و WebPartZoneBase.CreateVerbsحدث.

يظهر المثال تعليمات برمجية التالي كيفية إنشاء مخصص WebPartVerbالكائن، ومنطقة مخصصة التي تستخدم OnCreateVerbsطريقة لإضافة الفعل إلى قائمة الأفعال كل WebPartعنصر تحكم الموجودة في المنطقة. There are الرابع parts إلى the تعليمات برمجية مثال:

  • ملف مصدر الذي يحتوي على مخصص بسيط WebPartعنصر تحكم التي تعرض بعض نص.

  • ملف مصدر يحتوي على cusإلىm WebPartVerbالكائن، cusإلىm بسيطة WebPartZoneBaseمنطقة يتجاوز OnCreateVerbsالأسلوب إلى إضافة إلى فعل cusإلىm WebPartعناصر التحكم في المنطقة.

  • صفحة ويب تحتوي على منطقة مخصصة و المخصصة WebPartعنصر تحكم.

  • شرح كيفية مثال يعمل.

الجزء أول من المثال تعليمات برمجية يحتوي على تعليمات برمجية المصدر التي تنشئ بسيطة WebPartعنصر تحكم التي تعرض بعض نص. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . This تعليمات برمجية مثال uses the ديناميكي compilation approach. للحصول على الإرشادات التفصيلية التي توضح كيفية التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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


الجزء الثاني من المثال يحتوي على تعليمات برمجية المصدر إلى إنشاء المنطقة cusإلىm و cusإلىm WebPartVerbالكائن. لاحظ أن يتجاوز المنطقة OnCreateVerbsالأسلوب إلى إضافة الفعل cusإلىm إلى أي WebPartعناصر التحكم في المنطقة. الفعل هو إضافتها بشكل افتراضي إلى قائمة الأفعال من عناصر التحكم. لاحظ أنه، في تعليمات برمجية للفعل المخصصة، الدالة الإنشائية للاستخدامات الفعلية الخادم انقر فوق معالج، كما أن أسلوب يدعى ينشئ نسخ كاملة من أي عنصر التحكم الذي يرث مباشرة من WebPartفئة، وإضافة النسخ الجديدة التي تم إنشاؤها بنفس المنطقة. يجب أن يتم ترجمة تعليمات برمجية المصدر هذا مثل الجزء أول من المثال تعليمات برمجية، وفي هذا المثال تم وضع الملف المصدر في مجلد فرعي App_Code إلى يكون التجميع حيويا.


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


الجزء الثالث من مثال التعليمة البرمجية هو صفحة ويب التي تستضيف عناصر التحكم. لاحظ أن هناك هو Registerالتوجيه قريب أعلى الصفحة لتعريف مساحة الاسم لعناصر التحكم المخصصة. لا تجميع هو التصريح بسبب th هو يستخدم المثال التحويل البرمجي ديناميكي. مخصص WebPartعنصر التحكم هو معرفة في منطقة مخصصة. يمكن أيضا الإعلان عن آخر WebPartعناصر التحكم في هذه المنطقة، و فعل المخصصة سيتم إضافتها إلى قوائم الأفعال الخاصة بهم جيدا.


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


تحميل الصفحة في مستعرض، ثم انقر فوق قائمة الأفعال تشغيل مخصص WebPartعنصر التحكم. يجب أن يكون الفعل نسخ جزء ويب مرئياً. انقر the فعل, و ملاحظة that a نسخ of the عنصر تحكم هو تمت الإضافة إلى the منطقة.

System.Object
  System.Web.UI.WebControls.WebParts.WebPartVerb

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: