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.

EditorZone الفئة

Visual Studio 2010

يخدم كعنصر تحكم أساسي في عنصر تحكم "أجزاء ويب" لتعيين لاستضافة EditorPartعناصر التحكم على صفحة ويب.

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

public class EditorZone : EditorZoneBase
<asp:EditorZone />

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

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

EditorZone عنصر تحكم يصبح مرئياً على صفحة "أجزاء ويب" يقوم بإدخال الوضع التحرير، ولكنه يتيح متعددة EditorPartعنصر تحكم s التي يمكن استخدامها لإضفاء طابع شخصي WebPartعنصر تحكم s. EditorZone عنصر التحكم هو مشابهة جداً للأصل، EditorZoneBaseالفئة، مع وجود اختلاف واحد المفتاح: EditorZoneعنصر تحكم توفير قالب منطقة، والمشار إليها في به ZoneTemplateخاصية. يضيف قالب المنطقة القدرة على إلى التصريح بمحتوى في تنسيق استمرارية الصفحة. يمكن للمطورين صفحة وضع EditorZoneالتحكم في علامات مصرحة صفحة ويب، إضافة فرع <zonetemplate>عنصر، وضمن <zonetemplate>عنصر، قم بإضافة مراجع مصرحة EditorPartعناصر التحكم.

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

ملاحظةملاحظة

butإلىns في EditorZoneتتطلب واجهة المستخدم النصية من جانب العميل في ترتيب إلى تعمل بشكل صحيح. إذا كان البرنامج النصي هو dهوabled في مستعرض، مستخدم لن تكون قادراً على تنفيذ الإجراءات من خلال EditorZoneواجهة مستخدم.

‏إمكانية وصول ذوي الاحتياجات الخاصة

ترميز تقديمها بشكل افتراضي لهذا عنصر تحكم قد لا تتوافق مع مقاييس إمكانية التشغيل مثل إرشادات الأولوية 1 ويب المحتوى التشغيل إرشادات 1.0 (WCAG). للحصول على التفاصيل حول دعم الوصول لهذا عنصر تحكم، راجع عناصر تحكم ASP.NET و إمكانية التشغيل.

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

If you want إلى إنشاء a مخصص EditorZone منطقة إلى gain greater عنصر تحكم over the رسم هندسي of the ‏‏تحرير واجه المستخدم, you can يورث directly من the EditorZoneBase فئة, كـ long كـ you do not need إلى provide منطقة قالب دعم for الصفحة developers إلى إضافة EditorPart عناصر التحكم إلى your منطقة declaratively. في such a حالة, you would إضافة الجميع EditorPart عناصر التحكم إلى a منطقة programmatically. If you want إلى provide منطقة قالب دعم, you should يورث من the EditorZone فئة.

يوضح المثال تعليمات برمجية التالي عدة استخدامات مصرحة والمبرمج من EditorZoneفئة. The مثال creates a مخصص محرر منطقة that inherits من the EditorZone فئة, و uses it في a ويب Parts الصفحة.

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

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

  • أ صفحة ويب التي تشير مخصص EditorZoneعنصر التحكم.

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

الجزء أول من هذا المثال تعليمات برمجية هو عنصر تحكم مستخدم الذي يمكن مستخدمين من إلى تغيير أوضاع عرض تشغيل صفحة ويب. For المزيد تفاصيل حول عرض modes و a وصف of the المصدر تعليمات برمجية في this عنصر تحكم, see الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويب.


<%@ control language="C#" classname="DisplayModeMenuCS"%>

<script runat="server">

 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }

  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, 
    EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>


The ثانية part of the تعليمات برمجية مثال هو a ويب الصفحة. قريب أعلى الصفحة هو Registerموجها عنصر تحكم مستخدم. The مستخدم عنصر تحكم علامة هو declared في the الصفحة مع a uc1: بادئة for the عنصر. لاحظ أنه أدناه <asp:WebPartZone>عنصر هو <asp:EditorZone>العنصر الذي يحتوي على عدة EditorPartتعيين عناصر تحكم، مع بعض علامات والخصائص لتحديد به المظهر والسلوك. وهناك أيضا عدد من الطرق التي يمكنها الوصول إلى عدة الأعضاء EditorZoneعنصر تحكم برمجياً.


<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>

<!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 == true)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }

  void Button2_Click(object sender, EventArgs e)
  {
    EditorZone1.BorderWidth = 2;
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
  }

  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)
  {
    EditorZone1.InstructionText = "My custom instruction text.";
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" 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>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>


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

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