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.

Part الفئة

Visual Studio 2010

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

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

public abstract class Part : Panel, 
	INamingContainer, ICompositeControlDesignerAccessor
<asp:Part />

Part فئة تعريف الخصائص عام إلى كل جزء عناصر التحكم وتمكينهم إلى يكون المظهر نمطي، وثابتة تشغيل صفحة ويب. تضمين هذه الخصائص عام لعنوان ووصف الصفات المميزة للكروم أو الإطار الذي يحيط بجزء عنصر تحكم.

Title تحدد خاصية عنوان عنصر تحكم الجزء. Description خاصية هو المستخدم لتلخيص الغرض الخاص بعنصر التحكم جزءا، ويظهر تعريف أداة في شريط عنوان الخاص بعنصر التحكم. ChromeType الخصائص تحدد نوع الحد هو تقديم حول عنصر تحكم الجزء، بينما ChromeStateخاصية تشير إلى ما إذا كان التحكم في جزء هو تقديمها بشكل عادي أو مصغر. حدود عنصر تحكم الجزء هو تتأثر بخصائص المنطقة التي تحتوي على؛ على سبيل المثال، PartChromeTypeتؤثر خاصية إطارات الجميع جزء عناصر التحكم الموجودة في المنطقة.

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

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

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

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

بعض أمثلة أنواع الجزء الأساسي، و أنواعها المقابلة للمنطقة، موضحة في الجدول التالي.

جزء عنصر تحكم نوع

نوع المنطقة

WebPart

WebPartZone

EditorPart

EditorZone

CatalogPart

CatalogZone

أنواع عديدة من جزء عناصر التحكم الذي ينحدر من Partفئة معالجة الخصائص الموروثة، معتمداً على واجهة المستخدم بطريقة مختلفة. WebPart عناصر التحكم وتجاوز العديد من الخصائص الموروثة لواجهة المستخدم، ووضع علامة عليها باستخدامPersonalizableسمة (راجع PersonalizableAttributeالوثائق لفئة)، الذي يمكن قيم هذه الخصائص إلى حفظ لجلسات عمل مستعرض المستقبلية، ميزة المعروفة بإضفاء الطابع الشخصي. على سبيل المثال، إذا قمت بممكّن أي مستخدم بتحديث القيمة WebPartعنصر التحكم برمجياً Titleخاصية أثناء وقت التشغيل، والتي سوف يتم تخصيص قيمة (مع افتراض أن إضفاء الطابع الشخصي هو ممكنة، الذي هو الافتراضي). عدة واجه المستخدم خصائص ذلك WebPartيورث عناصر التحكم Partفئة، ومن WebControlللفئات، معالجة بنفس الطريقة.

وفي المقابل، جزء آخر عناصر، مثل EditorPartو CatalogPart، لا تقم بتمكين خصائص واجهة المستخدم الموروثة إلى يمكن تخصيصها. ولهذا السبب، قم بتعيين خاصية لن يتم تم الحفظ قيم للجلسات المستقبلية مستعرض برمجياً. على سبيل المثال، إذا قمت بتمكين أي مستخدم بتحديث PropertyGridEditorPartعنصر التحكم برمجياً Titleخاصية أثناء وقت التشغيل، القيمة التي تم تحديثها يتم فقدان بعد مغلق عنصر التحكم أو جلسة عمل مستعرض اﻷطراف.

طريقة سهلة لحفظ قيم تشغيل سبيل وراثة خصائص واجهة المستخدم ل EditorPartو CatalogPartعناصر التحكم في الجلسات المستقبلية مستعرض هو التصريح بقيم الخصائص في تنسيق persهوtence الصفحة. ومع ذلك، رقم هو هو طريقة ثابتة واستمرار عدم عدم السماح للمستخدمين تخصيص قيم الخصائص. كبديل، إذا كنت تريد إلى تمكين التحديثات البرمجية إلى الموروثة خصائص واجهة المستخدم حيث يمكن للمستخدمين تخصيص إليهم في وقت التشغيل، يمكنك استخدام متغيرات خاصة وثباتاً إلى حفظ قيم الخصائص. كل مرة تقوم نسخة جديدة من EditorPartأو CatalogPartعنصر التحكم هو تاريخ الإنشاء (على سبيل المثال، في الطريقة التي يتعامل مع عنصر التحكم Initحدث)، يمكنك إعادة تعيين القيمة المتغير الثابت للخاصية المناظرة. يعطي مثل هذا أسلوب المستخدمين القدرة على إلى تخصيص واجهة المستخدم ‏‏تحرير وإنشاء نشرة مصورة لواجهة المستخدم لتطبيق "أجزاء ويب".

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

عادة، يجب أن لا يورث مباشرة من Partفئة لتطوير "أجزاء ويب" المخصصة عناصر التحكم. لتوفير وظائف "أجزاء ويب" كاملة، "أجزاء ويب" عنصر تحكم يتطلب مجموعة الفئات المشتقة من Partللفئات، namely WebPart، EditorPart، و CatalogPart، لذا يجب اشتقاق منها لتطوير عنصر تحكم s. مخصصة ومع ذلك، فإنه هو لا يزال يجب فهم سلوك الأساسية Partللفئات، لأنها توفر التعيين شائعة من الخصائص المستخدمة من قبل الجميع الأخرى جزء الفئات.

توضح الأمثلة تعليمات برمجية التالية استخدام عدة خصائص Partالفئة، باستخدام مثيلين من مخصص مصرحة WebPartالمشار إليه في صفحة ويب ASP.NET عنصر تحكم الصفحة. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . للإرشادات التفصيلية التي توضح كلا الأسلوبين التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.

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


using System;
using System.Security.Permissions;
using System.Web;
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;
    const string _subTitle = "Contoso, Ltd";

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      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);
      ChildControlsCreated = true;
    }

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


الجزء الثاني من المثال يوضح كيفية الإشارة إلى عناصر التحكم المخصصة جزءا في ASP.NET صفحة ويب. لاحظ أنه المتنوعة Partالخصائص المعينة بشكل إلزامي للمخصصة عنصر تحكم مثيلات. يقارن مصرحة تعليمات برمجية الذي يرجع مثيلين من الصفحة، ومن ثم تحميل الصفحة في مستعرض. ملاحظة كيف تؤثر الخصائص المختلفة لمظهر عناصر التحكم. على سبيل المثال، بعد تحميل الصفحة في مستعرض، المثيل الثاني من TextDisplayWebPartيظهر عنصر تحكم مصغر، لأن به ChromeStateالقيمة خاصية هو تعيين إلى Minimized.


<%@ page language="C#" %>
<%@ 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>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>


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