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.

EditorZoneBase الفئة

Visual Studio 2010

يعمل كالاساس فئة لكل منطقة من عناصر التحكم التي تعمل حاويات ل EditorPartعناصر التحكم.

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

public abstract class EditorZoneBase : ToolZone
<asp:EditorZoneBase />

EditorZoneBase الفئة هو فئة خاصة لمنطقة التي ترث من ToolZone للفئات وتوفير التعيين أساسية من السلوكيات المشتقة من المناطق التي تحتوي على EditorPartعناصر التحكم. هناك عدة غير ذلك أنواع ToolZoneفئات؛ للحصول على مزيد من المعلومات، راجع نظرة عامة حول الموضوع ToolZoneفئة. في المناطق الأخرى الأداة، EditorZoneBaseمناطق غير vهوible عند صفحة هو في الوضع الاستعراض العادي؛ فهي vهوible فقط عند صفحة هو في تحرير الالوضع dهوplay. ترغب أيضا غير ذلك مناطق الأداة، EditorZoneBaseمناطق يمكن أن يحتوي فقط على نوع خاص من عناصر التحكم التي تم تصميمها تحتوي على (في هذه الحالة، EditorPartعناصر التحكم).

EditorZoneBase مناطق توفر واجهة مستخدم خاص ‏‏تحرير عناصر التحكم التي تحتوي عليها. العديد من عناصر واجهة المستخدم هذه تكون مشتركة في الجميع المناطق في "أجزاء ويب" عنصر تحكم تعيين. لمناقشة تفصيلية للمشترك واجه المستخدم العناصر في مناطق "أجزاء ويب"، راجع الموضوع نظرة عامة حول فئة ل WebZoneclass.

لأن EditorZoneBaseالفئة هو مجردة، لا يمكنك استخدامها مباشرة تشغيل صفحة ويب. بدلاً من ذلك، يجب استخدام عناصر تحكم التي ترث من EditorZoneBaseفئة وتنفيذ سلوك الخاص به. يمكنك أما استخدام مشتق منطقة هو المتوفرة في التعيين تحكم "أجزاء ويب" EditorZoneعنصر تحكم، أو يمكنك الحصول على المخصص الخاص بك EditorZoneBaseعنصر التحكم.

EditorZoneBase توفر الفئة عامة واجهة مستخدم (واجه المستخدم) إلى تحتوي على عناصر تحكم خاص بتمكين المستخدمين النهائيين إلى تحرير الخصائص التخطيط، المظهر والسمات الأخرى ل WebPartعناصر التحكم. بعض الخصائص التي يتم تطبيقها إلى راجع واجهة المستخدم إلى الأفعال، مثل ApplyVerb، CancelVerb، و OKVerbالخصائص. الأفعال الإجراءات عام التي يتم تنفيذها من قبل المستخدمين تشغيل صفحة، ويتم تمثيلها في واجه المستخدم الأزرار أو الارتباطات، عناصر قائمة أو عناصر غير ذلك. تشغيل سبيل المثال، عندما يقوم المستخدمين بتحرير الخصائص من عنصر تحكم يمكنهم النقر فوق فعل يطبق إلى حفظ التغييرات.

عدة خصائص غير ذلك تؤثر على نص الذي هو dهوplayed على نقاط مختلفة في واجهة المستخدم التحرير. These include theEmptyZoneText,ErrorText,HeaderText, andInstructionTextخصائص.

توفر الخاصيتين هام مراجع لعناصر التحكم المرتبطة. EditorParts خاصية هو مجموعة EditorPartعناصر التحكم الموجودة في المنطقة. WebPartToEdit خاصية هو مرجع كائن إلى عنصر تحكم موجود في WebPartZone– الذي قد يكون WebPartعنصر التحكم أو أي غير ذلك ASP.NET عنصر تحكم الخادم أو عنصر تحكم مستخدم أو عنصر تحكم مخصص الذي يتم تحريره حاليا.

وأخيراً، EditorPartChromeتشير خاصية مثيل EditorPartChromeالكائن التي تقترن بالمنطقة، والتي تحتوي على خصائص النمط من جهاز ملحق عناصر واجهة المستخدم (يعرف بالكروم) مثل عنوان والحد من أنماط EditorPartعناصر التحكم في المنطقة.

عدد من الطرق EditorZoneBaseهي التخصصية فئة للتعامل مع ‏‏تحرير لعناصر التحكم الأخرى. Close أسلوب التغييرات النسخ الاحتياطي للصفحة من الوضع عرض التحرير إلى عادي استعراض عرض. CreateEditorPartChrome أسلوب هو لإنشاء كروم (الطرفية عناصر واجهة المستخدم مثل حد الأفعال، الرموز وعنوان) التي تحيط كل EditorPartالتحكم في المنطقة. CreateEditorParts أسلوب هو أسلوب مجرد؛ الفئات المشتقة تجاوزه لإنشاء مثيلات لكل EditorPartعناصر التحكم الموجودة في المنطقة. InvalidateEditorParts يمكن استدعاء الأسلوب بفئة مشتقة إذا المجموعة EditorPartعنصر تحكم s بتغير المنطقة لسبب المبرمج، ووضع علامات على "أجزاء ويب" عنصر تحكم تعيين إعادة إنشاء وتحديث المجموعة EditorPartعنصر تحكم s. OnDisplayModeChanged أسلوب هو المستخدمة لتعيين المجموعة EditorPartعناصر التحكم إلى nullعند نسخ التغييرات وضع dهوplay من وضع التحرير لاستعراض الوضع. وأخيراً، OnSelectedWebPartChangedأسلوب يستخدم لمعالجة حدث عند WebPartعنصر تحكم هو إدخال أو ترك تحرير الالوضع. على سبيل المثال، رقم هو أسلوب هو مكاناً مناسباً مزامنة قيم خاصية WebPartعنصر تحكم يحتوي على قيم قابلة للتحرير في المقترنة EditorPartعناصر التحكم.

ملاحظات للمسئولين عن الإرث

إذا أردت أن إلى تطوير منطقة cusإلىm لاستضافة EditorPartعناصر التحكم، يجب عليك تحديد ما إذا كنت تريد إلى بتوفير قالب منطقة دعم. قالب منطقة يتم إنشاؤه بواسطة الأنواع التي تقوم بتنفيذ ITemplateالواجهة، و ضروريا إذا كنت تريد تمكين المطورين صفحة باستخدام المنطقة المخصصة للرجوع إلى EditorPartعناصر التحكم داخل المنطقة في العلامة مصرحة من صفحة ويب. إذا كنت تحتاج إلى منطقة قالب الدعم، يجب أن يورث EditorZoneفئة.

وعلى العكس، إذا المنطقة المخصصة الخاصة بك وبه EditorPartسيتم عناصر التحكم لتكون مستقلة، والتي سوف يتم تاريخ الإنشاء برمجياً بدون أية خيارات للمطورين الصفحة لتعيين عناصر التحكم بشكل إلزامي في قالب منطقة، ثم يمكنك يورث مباشرة من EditorZoneBaseفئة. إذا قمت بترتيب هو، هو هامة تطبيق CreateEditorPartsأسلوب حيث المنطقة المخصصة الخاصة بك سوف العمل.

يوضح المثال تعليمات برمجية التالي عدة استخدامات مصرحة والمبرمج من EditorZoneBaseفئة. نظراً لأن الفئة هو مجردة، الأمثلة تعليمات برمجية باستخدام المشتق EditorZoneالفئة الذي يأتي مع تعيين التحكم "أجزاء ويب"، demonstrating الخصائص والأساليب التي ترث من EditorZoneBaseفئة.

تعليمات برمجية مثال على الرابع أجزاء:

  • عنصر تحكم مستخدم يتيح لك إلى تغيير أوضاع عرض في صفحة ويب.

  • صفحة ويب تحتوي على EditorZoneعنصر تحكم.

  • مخصص EditorZoneفئة الذي يوضح بعض EditorZoneBaseفئة الأعضاء.

  • وصف كيفية مثال يعمل في مستعرض.

المصدر تعليمات برمجية للمستخدم التحكم تأتي من موضوع آخر. على سبيل المثال تعليمات برمجية للعمل، تحتاج إلى الحصول على ملف.ascx لعنصر تحكم مستخدم من الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويبموضوع، ومكان الملف في نفس المجلد مثل الصفحة.aspx في هذا المثال تعليمات برمجية.

الجزء الثاني من مثال التعليمة البرمجية صفحة ويب الذي يحتوي على مرجع مصرحة على EditorZoneعنصر التحكم. قريب أعلى الصفحة هو Registerموجها عنصر تحكم مستخدم. علامة عنصر تحكم مستخدم هو التي تم تعريفها في الصفحة التي تحتوي <uc1:DisplayModeMenu>العنصر. لاحظ أنه أدناه <asp:WebPartZone>عنصر هو <asp:EditorZone>العنصر الذي يحتوي على EditorPart، وعناصر التحكم ويحتوي على العديد من علامات والخصائص المعينة لتحديد به المظهر والسلوك. يوضح معظم تعليمات برمجية في الصفحة متنوع برمجي يستخدم EditorZoneBaseالخصائص والأساليب.


<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
<%@ register tagprefix="aspSample" 
  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">
<script runat="server">

  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }
  void Button2_Click(object sender, EventArgs e)
  {
    if (EditorZone1.CancelVerb.Enabled)
      EditorZone1.CancelVerb.Enabled = false;
    else
      EditorZone1.CancelVerb.Enabled = true;
  }
  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  void Button4_Click(object sender, EventArgs e)
  {
    if (EditorZone1.OKVerb.Enabled)
      EditorZone1.OKVerb.Enabled = false;
    else
      EditorZone1.OKVerb.Enabled = true;
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>


الجزء الثالث من تعليمات برمجية المثال هو مخصص EditorZoneالفئة التي توضح كيفية التعامل مع عدد من EditorZoneBaseالأعضاء الفئة. فئة مخصصة مشتقة من EditorZoneحيث يمكن استخدامه مع قالب منطقة في علامات مصرحة الويب الصفحة. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . يستخدم هذا المثال رمز التحويل البرمجي ديناميكي؛ وهكذا، ستلاحظ التي Registerالتوجيه قريب أعلى صفحة ويب لا تشير ملف تجميع. للإرشادات التفصيلية التي توضح كلا الأسلوبين التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyEditorZone : EditorZone
  {
    public MyEditorZone()
    {
    }
    protected override void OnDisplayModeChanged(object sender, 
      WebPartDisplayModeEventArgs e)
    {
      this.BackColor = Color.LightGray;
      base.OnDisplayModeChanged(sender, e);
    }
    protected override void OnSelectedWebPartChanged(object sender, 
      WebPartEventArgs e)
    {
      if (e.WebPart != null)
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
          Color.LightGreen;
      base.OnSelectedWebPartChanged(sender, e);
    }
    protected override void RenderBody(HtmlTextWriter writer)
    {
      writer.WriteLine("<hr />");
      base.RenderBody(writer);
    }
    protected override void RenderVerbs(HtmlTextWriter writer)
    {
      WebPartVerb[] verbs = new WebPartVerb[] { OKVerb, 
        CancelVerb, ApplyVerb };
      foreach (WebPartVerb verb in verbs)
      {
        if (verb != null)
          verb.Text += " Verb";
      }
      base.RenderVerbs(writer);
    }
  }
}


عندما تقوم بتحميل الصفحة في مستعرض، فيمكنك تحديد الوضع التحرير من قائمة منسدلة قائمة للتبديل إلى الوضع التحرير. يمكنك انقر فوق قائمة الأفعال (السهم إلى الأسفل) في شريط عنوان الخاص بأحد s عنصر تحكم اثنين، وانقر فوق تحرير لتحرير عنصر تحكم. عند عدم إظهار مربعات الحوار ‏‏تحرير هو vهوible، يمكنك مشاهدة تأثيرات مصرحة متعددة ويستخدم البرمجي EditorZoneBaseالأعضاء الفئة.

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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
إظهار: