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.

CatalogPartChrome الفئة

Visual Studio 2010

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

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

public class CatalogPartChrome

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

أجزاء ويب عنصر تحكم تستخدم التعيين من CatalogPartChromeفئة لتقديم كروم ل CatalogPartعنصر تحكم s. بالإضافة إلى ذلك، توفر هذه الفئة بطريقة للمطورين لتخصيص عرض أي CatalogPartعناصر التحكم في CatalogZoneBaseالمنطقة. على سبيل المثال، يمكنك يمنع CreateCatalogPartChromeStyleأسلوب إلى cusإلىmize تطبيق بعض السمات النمط معين إلى CatalogZoneBaseالمنطقة.

CatalogPartChrome فئة على العديد من الطرق الهامة والتي تعتبر مفيدة عندما تريد إلى يمنع العرض CatalogPartعناصر التحكم. واحد هو CatalogPartChromeالمنشئ، الذي تستخدمه عندما تقوم بتجاوز CreateCatalogPartChromeالأسلوب في مخصص CatalogZoneBaseمنطقة لإنشاء مثيل المخصص الخاص بك CatalogPartChromeالكائن. هي طريقة مفيدة أخرى RenderPartContentsالأسلوب، الذي يمكنك استخدامه ل عنصر تحكم عرض مساحة المحتويات الفعلية ل s عنصر تحكم في مساحة (بعكس كروم عناصر مثل الرؤوس والتذييلات وأشرطة العناوين). وأخيراً، إذا كنت تريد التحكم البرمجي بشكل كامل عبر الجميع أوجه رسم هندسي CatalogPartعناصر التحكم، يمكنك يمنع RenderCatalogPartالأسلوب.

ملاحظات للقائمين بالتنفيذ

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

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

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

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

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

  • فئة الذي يحتوي على تعليمات برمجية المصدر ل مخصص CatalogPartChromeالفصل الدراسي و CatalogZoneBaseمنطقة.

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

الجزء الثاني من المثال صفحة ويب. لاحظ أن هناك هو Registerموجها قريب أعلى regهوter مكوّن المترجمة وبادئة علامة. لاحظ أيضا أن يشير الصفحة المخصصة كاتالوج منطقة استخدام عنصر <aspSample:MyCatalogZone>.


<%@ Page Language="C#" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" %>
<%@ Register TagPrefix="uc1" TagName="DisplayModeMenuCS" Src="~/DisplayModeMenuCS.ascx" %>
<!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>Web Parts Page</title>
</head>
<body>
  <h1>Web Parts Demonstration Page</h1>
  <form runat="server" id="form1">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS runat="server" ID="DisplayModeMenu" />
  <br />
  <table cellspacing="0" cellpadding="0" border="0">
    <tr>
      <td valign="top">
    <asp:webpartzone id="SideBarZone" runat="server" 
        headertext="Sidebar">
        <zonetemplate>
        </zonetemplate>
      </asp:webpartzone>
      <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
          <asp:ImportCatalogPart ID="ImportCatalog" runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
      </td>
      <td valign="top">
    <asp:webpartzone id="MainZone" runat="server" headertext="Main">
         <zonetemplate>
        <asp:label id="contentPart" runat="server" Title="Content">
              <h2>Welcome to My Home Page</h2>
              <p>Use links to visit my favorite sites!</p>
            </asp:label>
         </zonetemplate>
       </asp:webpartzone>
      </td>
      <td valign="top">
      </td>
    </tr>
  </table>
  </form>
</body>
</html>


يتضمن الجزء الثالث من المثال تنفيذ المخصصة كاتالوج كروم جزء و كاتالوج جزء منطقة. MyCatalogZoneتوسيعCatalogZoneويتجاوزCreateCatalogPartChromeلإرجاع المخصصة كاتالوج جزء كروم. MyCatalogPartChromeتغير اللون الالخلفية من كاتالوج عنصر تحكم فيCreateCatalogPartChromeStyleأسلوب. يتم تم تغييره اللون الخلفية للمنطقة في PerformPreRenderالأسلوب، ونص يضاف إلى كاتالوج جزء في RenderPartContentsالأسلوب.


namespace Samples.AspNet.CS.Controls
{

    /// <summary>
    /// Summary description for source
    /// </summary>
    public class MyCatalogPartChrome : CatalogPartChrome
    {
        public MyCatalogPartChrome(CatalogZoneBase zone)
            : base(zone)
        {

        }

        protected override Style  CreateCatalogPartChromeStyle(CatalogPart catalogPart, PartChromeType chromeType)
        {
            Style catalogStyle = base.CreateCatalogPartChromeStyle(catalogPart, chromeType);
            catalogStyle.BackColor = Color.Bisque;
            return catalogStyle;
        }

        public override void PerformPreRender()
        {
            Style zoneStyle = new Style();
            zoneStyle.BackColor = Color.Cornsilk;

            Zone.Page.Header.StyleSheet.RegisterStyle(zoneStyle, null);
            Zone.MergeStyle(zoneStyle);
        }

        protected override void  RenderPartContents(HtmlTextWriter writer, CatalogPart catalogPart)
        {
            writer.AddStyleAttribute("color", "red");
            writer.RenderBeginTag("p");
            writer.Write("Apply all changes");
            writer.RenderEndTag();
            catalogPart.RenderControl(writer);
        }

        public override void  RenderCatalogPart(HtmlTextWriter writer, CatalogPart catalogPart)
        {
            base.RenderCatalogPart(writer, catalogPart);
        }
    }

    public class MyCatalogZone : CatalogZone
    {
        protected override CatalogPartChrome  CreateCatalogPartChrome()
        {
            return new MyCatalogPartChrome(this);
        }
    }
}


System.Object
  System.Web.UI.WebControls.WebParts.CatalogPartChrome

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