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.

WebPartZone الفئة

Visual Studio 2010

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

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

public class WebPartZone : WebPartZoneBase
<asp:WebPartZone />

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

وظيفة خاص WebPartZoneعنصر التحكم هو لاحتواء WebPartعناصر التحكم، والتي تشكل الرئيسي "أجزاء واجهة مستخدم ويب" التطبيقات. WebPartZone تعريف عنصر التحكم بتنسيق مستمر على صفحة ويب، تمكين المطورين لاستخدامه كقالب و إلى إضافة عناصر أخرى تحكم الخادم ضمن <asp:webpartzone>العنصر. أي نوع من خادم عناصر التحكم إذا تمت الإضافة WebPartZoneمنطقة, يمكن أن تكون دالة مثل WebPartعنصر التحكم في وقت التشغيل. Th هو هو صحيحاً بغض النظر عن ما إذا كان عنصر التحكم المضافة هو WebPartعنصر تحكم أو عنصر تحكم مستخدم، عنصر تحكم مخصص، أو عنصر تحكم ASP.NET. ل المزيد المعلومات، راجع الموضوع ل GenericWebPartفئة.

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

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

قد يقوم إنترنت مستكشف بتقديم الارتفاع WebPartZoneأو عناصر التحكم المضمنة الخاصة به بطريقة غير متوقعة، استناداً إلى الاتجاه منطقة. للحصول على تفاصيل أكثر، راجع الوثائق الخاصة LayoutOrientationأو Heightخصائص.

WebPartZone فئة مشتقة معظم سلوكه من الأساس WebZoneو WebPartZoneBaseفئات؛ يقوم Access بإضافة عضو واحد فريد، ZoneTemplateخاصية. Th هو تشير خاصية ITemplateالكائن، الذي هو قالب تسمح لمطوري الصفحة لتعريف عناصر التحكم الموجودة في منطقة ثابت باستخدام <zonetemplate>عنصر في علامات مصرحة على صفحة.aspx.

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

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

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

يعرض الجزء أول من المثال فئة مخصصة التي ترث من WebPartZoneالفئة والتي تعين الثاني من المنطقة الأساسية خصائص في الدالة الإنشائية.


using System;
using System.Collections;
using System.ComponentModel;
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 MyWebPartZone : WebPartZone
  {
    public MyWebPartZone()
    {
      base.VerbButtonType = ButtonType.Button;
      base.CloseVerb.Enabled = false;
    }
  }
}


يعرض الجزء الثاني من المثال صفحة تحتوي على مخصص WebPartZoneعنصر تحكم. لاحظ أن تتطلب الصفحة خاص Registerموجها قريب أعلى الصفحة للرجوع إلى تجميع الذي يحتوي على المخصصة منطقة. تحتوي هذه الصفحة أيضا تشغيل <asp:webpartmanager>العنصر، الذي هو تشغيل كل صفحة "أجزاء ويب". <cc1:MyWebPartZone> عنصر، والتي تمثل مخصص WebPartZoneعنصر تحكم، ويتضمن ASP.NET قياسية Calendarعنصر التحكم. لأن هو ضمن WebPartZoneالمنطقة، Calendarسوف يتم التفاف عنصر التحكم GenericWebPartالتحكم في وقت التشغيل، والذي يمكن أن تعمل WebPartعنصر التحكم.


<%@ Page Language="C#" %>
<%@ Register TagPrefix="cc1" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="MyWebPartZoneCS" %>

<!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">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server" />
      <cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
        <VerbStyle Font-Italic="true" />
        <PartChromeStyle BackColor="lightblue" />
        <PartStyle BackColor="gray" />
        <PartTitleStyle Font-Bold="true" />
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </cc1:MyWebPartZone>
    </div>
    </form>
</body>
</html>


قم بفحص ترميز مصرحة ل مخصص WebPartZoneعنصر تحكم. لاحظ أنه يمكنك تعيين الخصائص المختلفة على المستوى المنطقة في ترميز، كما هو موضح في التالية تعليمات برمجية المثال.

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

هو هامة لاحظ استخدم <zonetemplate>العنصر. هذا العنصر، كما هو موضح في مقطع "ملاحظات"، يتم طلب داخل WebPartZoneمنطقة إلى التفاف الثابتة WebPartعناصر التحكم التي يتم تعريفها في الصفحة.


<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>


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