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.

AppearanceEditorPart الفئة

Visual Studio 2010

Provides an محرر عنصر تحكم that enables إنهاء users إلى تحرير several مستخدم واجهة (واجه المستخدم) خصائص تشغيل an associated WebPart عنصر تحكم. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class AppearanceEditorPart : EditorPart
<asp:AppearanceEditorPart />

The AppearanceEditorPart فئة هو an محرر control that derives من the EditorPart فئة, و هو used إلى تحرير الخصائص that affect the المظهر of an associated WebPart أو غير ذلك عنصر تحكم الخادم.

يُمكن عنصر التحكم AppearanceEditorPart المستخدمين من تحرير خصائص متعددة لواجهة المستخدم لعنصر التحكم WebPart . The نوع of عنصر تحكم that appears في the الصفحة إلى تحرير each قيمة الخاصية هو listed في the adjacent خلية of the following جدول.

الخصائص

عنصر تحكم used إلى تحرير خاصية

Title

A TextBox عنصر تحكم هو used إلى التعيين the نص for the عنوان.

ChromeType

A DropDownList عنصر تحكم هو used إلى تحديد what نوع of عنوان-و-حد خيار هو used.

Direction

A DropDownList عنصر تحكم هو used إلى تحديد the الاتجاه that محتوى flows تشغيل the الصفحة.

Height

A TextBox عنصر تحكم هو used إلى التعيين a رقم for the ارتفاع, و a DropDownList عنصر تحكم هو used إلى تحديد the وحدات.

Width

A TextBox عنصر تحكم هو used إلى التعيين a رقم for the ارتفاع, و a DropDownList عنصر تحكم هو used إلى تحديد the وحدات.

Hidden

A CheckBox عنصر تحكم هو used إلى indicate whether the عنصر تحكم هو مخفي.

The AppearanceEditorPart عنصر تحكم becomes مرئي فقط when a ويب Parts الصفحة هو في ‏‏تحرير الوضع, و when a specific WebPart عنصر تحكم has been محدد for ‏‏تحرير. The AppearanceEditorPart عنصر تحكم, مثل الجميع غير ذلك EditorPart عناصر التحكم, resides في an EditorZone منطقة.

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

EditorZone منطقة يمكن أن يتضمن فقط EditorPartعناصر التحكم، و EditorPartلا يمكن وضع عناصر التحكم في أي غير ذلك نوع المنطقة.

The AppearanceEditorPart فئة has a الأدنى التعيين of خصائص. Title الخاصية هو يستخدم لقراءة أو تعيين سلسلة هو dهوplayed كعنوان عند عنصر التحكم هو vهوible. The DefaultButton خاصية sets the inherited خاصية من the Panel عنصر تحكم, so that the الافتراضي عنصر تحكم that receives the تركيز within the AppearanceEditorPart عنصر تحكم هو the same كـ the الافتراضي في the الأساس Panel عنصر تحكم.

The AppearanceEditorPart فئة also has الثاني important وظائف. The SyncChanges أسلوب overrides the الأساس أسلوب من the EditorPart فئة. هذا الأسلوب ضروري لأنه يمكن الحصول على قيم الخاصية من WebPartعنصر تحكم التحرير وتعيينهم إلى حقول الموجودة في عنصر التحكم محرر. The ApplyChanges أسلوب هو also important, because it takes the قيم التعيين بواسطة the مستخدم في the ‏‏تحرير عناصر التحكم, و تحديثات those خاصية قيم تشغيل the عنصر تحكم being تم تحريره.

في معظم حالات AppearanceEditorPartعنصر تحكم يستخدم في تنسيق استمرارية الصفحة قبل التصريح <asp:appearanceditorpart>عنصر داخل <zonetemplate>عنصر موجود بدوره <asp:editorzone>عنصر على صفحة ويب.

لتحرير الخصائص وسلوك WebPartعنصر تحكم s الأخرى، يمكنك استخدام الآخر EditorPartعنصر تحكم s المتوفرة مع "أجزاء ويب" عنصر تحكم. التعيين These عناصر التحكم تضمين the BehaviorEditorPart, the LayoutEditorPart, و the PropertyGridEditorPart. التي تم توفيرها EditorPartيجب أن توفر عناصر تحكم معظم ميزات التحرير المطلوبة إلى ‏‏تحرير WebPartعناصر التحكم، ولكن يمكن أيضا إنشاء عنصر تحكم ediإلىr cusإلىm بوراثة من EditorPartفئة. مثال التعليمات برمجية، انظر في EditorPartفئة نظرة عامة حول الموضوع.

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

لتحسين إمكانية وصول ذوي الاحتياجات الخاصة، AppearanceEditorPartعنصر تحكم تقديم داخل <fieldset>العنصر. The <fieldset> عنصر groups the related التعيين of عناصر التحكم used for ‏‏تحرير في the AppearanceEditorPart عنصر تحكم, و it facilitates tabbed التنقل among those عناصر التحكم for كلاهما visual (such كـ ordinary ويب المستعرضات) و كلام-oriented مستخدم agents (such كـ شاشة-reading software).

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

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

يوضح مثال التعليمة البرمجية التالية كيف يتم التصريح AppearanceEditorPartالتحكم الموجودة صفحة ويب، وتمكينها لتحرير خصائص واجهة المستخدم العديد من WebPartعنصر التحكم. تعليمات برمجية مثال على الرابع أجزاء:

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

  • A ويب الصفحة that يحتوي على an EditorZone عنصر تحكم و an AppearanceEditorPart عنصر تحكم, along مع a مرجع إلى a مخصص WebPart عنصر تحكم.

  • A فئة that يحتوي على a مخصص WebPart عنصر تحكم.

  • شرح كيفية مثال يعمل عند تحميل الصفحة في مستعرض.

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

الجزء الثاني من مثال التعليمة البرمجية صفحة ويب. It يحتوي على a declarative مرجع إلى an EditorZone عنصر تحكم, مع a فرع <zonetemplate> عنصر that يحتوي على declarative مراجع إلى an AppearanceEditorPart عنصر تحكم. Also, the الصفحة مراجع the مخصص WebPart عنصر تحكم, using a Register directive for the تجميع, و the <aspSample:TextDisplayWebPart> عنصر for the عنصر تحكم.


<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenu" 
  Src="DisplayModecs.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="TextDisplayWebPartCS" %>

<!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 id="Head1" runat="server">
    <title>
      Text Display WebPart with AppearanceEditorPart
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />          
        </zonetemplate>
      </asp:webpartzone> 
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
            runat="server" 
            Title="Edit TextDisplayWebPart Properties" />
        </ZoneTemplate>      
      </asp:EditorZone>
    </form>
  </body>
</html>


The third part of the تعليمات برمجية مثال هو a مخصص WebPart فئة named TextDisplayWebPart, which هو مشار إليها في the ويب الصفحة. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . للحصول على الإرشادات التفصيلية التي توضح كيفية التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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 TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);

    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (input.Text != String.Empty)
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }

  }
}


When you تحميل the الصفحة في a مستعرض, you can تحديد تحرير الوضع في the الوضع عرض إسقاط-أسفل عنصر تحكم إلى تبديل إلى تحرير الوضع. يمكنك النقر فوق قائمة الأفعال (السهم إلى الأسفل) في شريط عنوان TextDisplayWebPartعنصر تحكم، انقر فوق تحرير لتحرير عنصر تحكم. عند عدم إظهار مربعات الحوار ‏‏تحرير هو vهوible، يمكنك مشاهدة AppearanceEditorPartعنصر التحكم. إذا قمت بإجراء بعض التغييرات في واجهة المستخدم ‏‏تحرير ثم انقر فوق يطبق زر، يمكنك استخدام المنسدلة الوضع عرض-تغيير القائمة لإرجاع الصفحة إلى الوضع الاستعراض ومشاهدة التأثير الكامل لل‏‏تحرير.

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