CatalogPartChrome 類別

參考

定義

命名空間:: System.Web.UI.WebControls.WebParts

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

讓開發人員僅覆寫 CatalogPart 區域中 CatalogZoneBase 控制項之選取區段的呈現。

public ref class CatalogPartChrome

public class CatalogPartChrome

type CatalogPartChrome = class

Public Class CatalogPartChrome

繼承: Object
CatalogPartChrome

範例

下列程式碼範例示範如何使用 CatalogPartChrome 類別覆寫區域中控制項 CatalogZoneBase 的預設轉譯 CatalogPart 。

程式碼範例有三個部分：

使用者控制項，可讓您變更網頁元件頁面上的顯示模式。
裝載範例中所有控制項的網頁。
類別，包含自訂 CatalogPartChrome 類別和 CatalogZoneBase 區域的原始程式碼。

程式碼範例的第一個部分是使用者控制項。使用者控制項的原始程式碼來自另一個主題。若要讓此程式碼範例能夠運作，您必須從逐步解說：變更網頁元件頁面上的顯示模式主題取得使用者控制項的 .ascx 檔案，並將檔案放在此程式碼範例中與 .aspx 頁面相同的資料夾中。

範例的第二個部分是網頁。請注意，檔案頂端有指示 Register 詞可註冊已編譯的元件和標籤前置詞。另請注意，頁面會使用元素 <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>

<%@ Page Language="VB" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" %>
<%@ Register TagPrefix="uc1" TagName="DisplayModeMenuVB" Src="~/DisplayModeMenuVB.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:DisplayModeMenuVB 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>

範例的第三個部分包含自訂類別目錄元件 Chrome 和目錄元件區域的實作。 MyCatalogZone 擴充 CatalogZone 和覆寫 CreateCatalogPartChrome 以傳回自訂類別目錄元件 Chrome。 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);
        }
    }
}

Namespace Samples.AspNet.VB.Controls


    Public Class MyCatalogPartChrome
        Inherits CatalogPartChrome

        Public Sub New(ByVal zone As CatalogZoneBase)
            MyBase.New(zone)
        End Sub

        Protected Overrides Function CreateCatalogPartChromeStyle(ByVal catalogPart As System.Web.UI.WebControls.WebParts.CatalogPart, ByVal chromeType As System.Web.UI.WebControls.WebParts.PartChromeType) As System.Web.UI.WebControls.Style
            Dim editorStyle As Style
            editorStyle = MyBase.CreateCatalogPartChromeStyle(catalogPart, chromeType)
            editorStyle.BackColor = Drawing.Color.Bisque
            Return editorStyle
        End Function

        Public Overrides Sub PerformPreRender()
            Dim zoneStyle As Style = New Style
            zoneStyle.BackColor = Drawing.Color.Cornsilk

            Zone.Page.Header.StyleSheet.RegisterStyle(zoneStyle, Nothing)
            Zone.MergeStyle(zoneStyle)
        End Sub

        Protected Overrides Sub RenderPartContents(ByVal writer As System.Web.UI.HtmlTextWriter, ByVal catalogPart As System.Web.UI.WebControls.WebParts.CatalogPart)
            writer.AddStyleAttribute("color", "red")
            writer.RenderBeginTag("p")
            writer.Write("Apply all changes")
            writer.RenderEndTag()
            catalogPart.RenderControl(writer)
        End Sub

        Public Overrides Sub RenderCatalogPart(ByVal writer As System.Web.UI.HtmlTextWriter, ByVal catalogPart As System.Web.UI.WebControls.WebParts.CatalogPart)
            MyBase.RenderCatalogPart(writer, catalogPart)
        End Sub
    End Class

    Public Class MyCatalogZone
        Inherits CatalogZone

        Protected Overrides Function CreateCatalogPartChrome() As System.Web.UI.WebControls.WebParts.CatalogPartChrome
            Return New MyCatalogPartChrome(Me)
        End Function
    End Class
End Namespace

備註

Chrome 是指周邊使用者介面 (UI) 元素，這些元素會框住區域中每個網頁元件控制項或伺服器控制項。控制項的 Chrome 包含其框線、標題列，以及出現在標題列內的圖示、標題文字和動詞功能表。 Chrome 的外觀是在區域層級設定，並套用至區域中的所有控制項。

網頁元件控制項集會使用 CatalogPartChrome 類別來呈現控制項的 CatalogPart Chrome。此外，這個類別也提供一種方式，讓開發人員自訂區域中任何 CatalogPart 控制項 CatalogZoneBase 的轉譯。例如，您可以覆寫 CreateCatalogPartChromeStyle 方法來自訂套用至 CatalogZoneBase 區域的某些特定樣式屬性。

類別 CatalogPartChrome 包含數個重要方法，當您想要覆寫控制項的 CatalogPart 轉譯時，這些方法很有用。其中一個是 CatalogPartChrome 建構函式，當您覆寫 CreateCatalogPartChrome 自訂 CatalogZoneBase 區域中的方法來建立自訂 CatalogPartChrome 物件的實例時，會使用此建構函式。另一個實用的方法是方法 RenderPartContents ，您可以用來控制區域控制項內容區域的轉譯 (，而不是頁首、頁尾和標題列等 chrome 元素) 。最後，如果您想要完整以程式設計方式控制轉譯 CatalogPart 控制項的所有層面，您可以覆寫 RenderCatalogPart 方法。

給繼承者的注意事項

如果您繼承自 CatalogPartChrome 類別，您必須建立自訂 CatalogZone 區域以傳回自訂 CatalogPartChrome 類別。此類別概觀的範例區段示範如何建立自訂 CatalogZone 區域以傳回自訂 CatalogPartChrome 類別。

建構函式

CatalogPartChrome(CatalogZoneBase)

初始化 CatalogPartChrome 類別的新執行個體。

屬性

Zone	取得相關聯 CatalogZoneBase 區域的參考。

方法

CreateCatalogPartChromeStyle(CatalogPart, PartChromeType)	建立樣式物件，該樣式物件為 CatalogPart 物件呈現的每一個 CatalogPartChrome 控制項提供樣式屬性。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
PerformPreRender()	執行必須在呈現 CatalogPart 控制項之前完成的工作。
RenderCatalogPart(HtmlTextWriter, CatalogPart)	呈現完整的 CatalogPart 控制項及其所有區段。
RenderPartContents(HtmlTextWriter, CatalogPart)	呈現 CatalogPart 控制項的主要內容區域，但不包括頁首和頁尾。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

適用於

CatalogPartChrome 類別

定義

範例

備註

給繼承者的注意事項

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源