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.

WebPartChrome الفئة

Visual Studio 2010

تمكن المطورين لتجاوز العرض للمقاطع المحددة من WebPartأو ملقم عناصر التحكم في WebPartZoneBaseالمنطقة.

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

public class WebPartChrome

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

أجزاء ويب عنصر تحكم تستخدم التعيين من WebPartChromeفئة لتقديم كروم ل WebPartعنصر تحكم s. بالإضافة إلى ذلك، توفر هذه الفئة بطريقة للمطورين لتخصيص عرض أي مقطع مفرد (مثل عنوان أو تذييل الصفحة) من WebPartعناصر التحكم في WebPartZoneBaseالمنطقة دون الحاجة لمعالجة الجميع رسم هندسي لتلك عناصر التحكم. تشغيل سبيل المثال، يمكنك يمنع CreateWebPartChromeStyleأسلوب إلى cusإلىmize تطبيق بعض السمات النمط معين إلى WebPartZoneBaseالمنطقة، ولكن يمكن أن يعتمد تشغيل عرض الافتراضي إلى التعامل مع البقية.

WebPartChrome فئة على العديد من الطرق الهامة والتي تعتبر مفيدة عندما تريد إلى يمنع العرض WebPartعناصر التحكم. هي CreateWebPartChromeStyleالأسلوب، والذي يمكنك إلى تغيير السمات النمط Styleالمقترنة بكائن WebPartChromeكائن المستخدم إلى تقديم عنصر التحكم. آخر هو WebPartChromeconstrucإلىr الذي تستخدمه عندما تقوم بتجاوز CreateWebPartChromeالأسلوب في cusإلىm WebPartZoneBaseالفئة إلى إنشاء مثيل لجهاز cusإلىm WebPartChromeالكائن. هي طريقة مفيدة أخرى RenderPartContentsالأسلوب، الذي يمكنك استخدامه ل عنصر تحكم عرض مساحة المحتويات الفعلية ل s عنصر تحكم في مساحة (بعكس كروم عناصر مثل الرؤوس والتذييلات وأشرطة العناوين). GetWebPartVerbs الأسلوب من إلى استثناء أفعال معينة من تقديم، إذا كان لسبب ما لم تكن تريد المستخدمين إلى رؤية هذه الأفعال في واجهة المستخدم. وأخيراً، إذا كنت تريد التحكم البرمجي بشكل كامل عبر الجميع أوجه رسم هندسي WebPartعناصر التحكم، يمكنك يمنع RenderWebPartالأسلوب.

عدة خصائص WebPartChromeفئة هي أيضا مفيدة. Zone و WebPartManagerالخصائص لتوفير مراجع إلى منطقة مقترنة WebPartChromeكائن والحالي WebPartManagerالمثيل، على التوالي.

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

يورث WebPartChromeعند الحاجة لفئة إلى يمنع العرض الافتراضي لأقسام معينة من WebPartأو عناصر تحكم الملقم. يمكنك اختيار يمنع CreateWebPartChromeStyleالأسلوب، GetWebPartVerbsالأسلوب، وخاصة RenderPartContentsأو RenderWebPartأساليب، إلى cusإلىmize التقديم. إلى استخدم مخصصة WebPartChromeالفئة WebPartوضع عناصر التحكم في منطقة ما، منطقة مخصصة مشتقة من WebPartZoneBaseللفئات، وتجاوز به CreateWebPartChromeالأسلوب. للحصول تشغيل التفاصيل حول كيفية استخدام فرع WebPartChromeالكائن في منطقة ما، راجع مقطع مثال.

مثال التعليمة البرمجية التالية يوضح كيفية استخدام WebPartChromeفئة لتجاوز العرض الافتراضي من WebPartيتحكم في WebPartZoneBaseالمنطقة.

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

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

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

  • A فئة that يحتوي على the المصدر تعليمات برمجية for a مخصص WebPartZoneBase منطقة و a WebPartChrome فئة.

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

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

الجزء الثاني من المثال صفحة ويب. لاحظ أن هناك هو Registerموجها قريب أعلى regهوter مكوّن المترجمة وبادئة علامة. Also ملاحظة that the الصفحة مراجع the مخصص منطقة using the عنصر <aspSample:MyZone> و يتضمن several قياسي ASP.NET الخادم عناصر التحكم within the منطقة. The الخادم عناصر التحكم do not implement أي الفعلي functionality; they are used هنا فقط إلى illustrate how the WebPartChrome فئة features يطبق على رسم هندسي zones. ملاحظة that these الخادم عناصر التحكم, though they are not الفعلي WebPart عناصر التحكم, are each automatically wrapped (بواسطة ASP.NET) مع a GenericWebPart كائن at تشغيل الوقت, so they will have the same functionality كـ WebPart عناصر التحكم.


<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS"
  Src="~/DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="MyChromeCS" %>

<!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>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS id="menu1" runat="server" />
    <aspSample:MyZone ID="WebPartZone1" runat="server"
      RenderVerbsInMenu="true">
      <PartTitleStyle Font-Bold="true"
        BorderWidth="1" 
        BackColor="lightblue"/>
      <ZoneTemplate>
        <asp:Panel runat="server" id="panel1" 
          title="Vote on Issues" >
          <asp:RadioButtonList ID="RadioButtonList1" runat="server" >
            <asp:ListItem Value="1">Issue 1</asp:ListItem>
            <asp:ListItem Value="2">Issue 2</asp:ListItem>
            <asp:ListItem Value="3">Issue 3</asp:ListItem>
          </asp:RadioButtonList>
          <asp:Button ID="Button1" runat="server" Text="Cast Vote" />
        </asp:Panel>
        <asp:FileUpload ID="FileUpload1" runat="server" 
          title="Upload Files" />
      </ZoneTemplate>
    </aspSample:MyZone>
    <asp:WebPartZone ID="WebPartZone2" runat="server" />
    <asp:EditorZone ID="EditorZone1" runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
  </form>
</body>
</html>


The third part of the تعليمات برمجية مثال هو the المصدر for the مخصص WebPartZoneBase منطقة و a WebPartChrome فئة. في الدالة الإنشائية فئة مخصصة للمنطقة، تعليمات برمجية التحقق من MyZone.RenderVerbsInMenuخاصية. إذا $ $ $ $ قيمة هو true، يتم تقديم الأفعال في قائمة لكل من WebPartعناصر التحكم في المنطقة. هذا هو سلوك الافتراضي العادي، في عناصر التحكم "أجزاء ويب" التعيين. إذا MyZone.RenderVerbsInMenuالقيمة خاصية هو false، أي هو الافتراضي في ترتيب هو منطقة مخصصة، الأفعال التي يتم تقديمها على حدة كارتباطات في شريط عنوان الخاص بكل عنصر تحكم. لاحظ وجود رمز مكان في صفحة ويب <aspSample:MyZone>عنصر هو التصريح، هناك هو RenderVerbsInMenuسمة تم تعيينها true، الموقع تظهر الأفعال في قوائم تشغيل عناصر التحكم. اختبار هذه الميزة، يمكنك تعيين RenderVerbsInMenuالسمة إلى مصرحة false، ولاحظ كيف يتم تقديمها الأفعال كـ الارتباطات.

مخصص WebPartChromeيتجاوز فئة رسم هندسي تشغيل العديد من الطرق، و منطقة مخصصة بإنشاء مثيل MyWebPartChromeالفئة في به CreateWebPartChromeالأسلوب. ينطبق هذا مخصص التقديم إلى الصفحة. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد 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 MyZone : WebPartZone
  {
    private Boolean _renderVerbsInMenu;

    protected override WebPartChrome CreateWebPartChrome()
    {
      WebPartChrome theChrome = new MyWebPartChrome(this, 
        this.WebPartManager);
      if (RenderVerbsInMenu)
        this.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
      else
        this.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
      return theChrome;
    }

    public Boolean RenderVerbsInMenu
    {
      get { return _renderVerbsInMenu; }
      set { _renderVerbsInMenu = value; }
    }
  }


  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyWebPartChrome : WebPartChrome
  {
    WebPartZoneBase theZone;
    WebPartManager theManager;

    public MyWebPartChrome(WebPartZoneBase aZone, WebPartManager aManager) : 
      base(aZone, aManager)
    {
      theZone = aZone;
      theManager = aManager;
    }

    protected override WebPartVerbCollection GetWebPartVerbs(WebPart webPart)
    {
      ArrayList verbSet = new ArrayList();
      foreach (WebPartVerb verb in base.GetWebPartVerbs(webPart))
      {
        if (verb.Text != "Close")
          verbSet.Add(verb);
      }
      WebPartVerbCollection reducedVerbSet = 
        new WebPartVerbCollection(verbSet);
      return reducedVerbSet;
    }

    protected override Style CreateWebPartChromeStyle(WebPart part, 
      PartChromeType chromeType)
    {
      Style finalStyle = new Style();
      finalStyle.CopyFrom(base.CreateWebPartChromeStyle(part, chromeType));
      finalStyle.Font.Name = "Verdana";
      return finalStyle;
    }

    protected override void RenderPartContents(HtmlTextWriter writer, 
      WebPart part)
    {

        if (part == this.WebPartManager.SelectedWebPart)
          HttpContext.Current.Response.Write("<span>Not rendered</span>");
        else
          if(this.Zone.GetType() == typeof(MyZone))
            part.RenderControl(writer);
    }

  }
}


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

System.Object
  System.Web.UI.WebControls.WebParts.WebPartChrome

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