(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

CatalogPartChrome-Klasse

Ermöglicht Entwicklern, das Rendern ausschließlich für die ausgewählten Bereiche von CatalogPart-Steuerelementen in einer CatalogZoneBase-Zone zu überschreiben.

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

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

public class CatalogPartChrome

Der CatalogPartChrome-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeCatalogPartChromeInitialisiert eine neue Instanz der CatalogPartChrome-Klasse.
Zum Seitenanfang

  NameBeschreibung
Geschützte EigenschaftZoneRuft einen Verweis auf die zugeordnete CatalogZoneBase-Zone ab.
Zum Seitenanfang

  NameBeschreibung
Geschützte MethodeCreateCatalogPartChromeStyleErstellt das Stilobjekt, das die Stilattribute für jedes CatalogPart-Steuerelement bereitstellt, das vom CatalogPartChrome-Objekt gerendert wird.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodePerformPreRenderFührt Aufgaben aus, die vor dem Rendern von CatalogPart-Steuerelementen verarbeitet werden müssen.
Öffentliche MethodeRenderCatalogPartGibt ein vollständiges CatalogPart-Steuerelement mit allen zugehörigen Bereichen wieder.
Geschützte MethodeRenderPartContentsGibt den Hauptinhaltsbereich eines CatalogPart-Steuerelements wieder und schließt Header und Footer vom Rendering aus.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Das Chrom verweist auf die peripheren Elemente der Benutzeroberfläche, die alle in einer Zone enthaltenen Webparts-Steuerelemente oder Serversteuerelemente umgeben. Das Chrom eines Steuerelements umfasst dessen Rahmen und Titelleiste. Dazu gehören außerdem die Symbole, der Titeltext und das Verbenmenü in der Titelleiste. Die Darstellung eines Chroms wird auf der Zonenebene festgelegt und auf alle Steuerelemente in der Zone angewendet.

Der Webparts-Steuerelementsatz verwendet die CatalogPartChrome-Klasse, um das Chrom für CatalogPart-Steuerelemente zu zu rendern. Darüber hinaus ermöglicht diese Klasse Entwicklern die Anpassung von beliebigen CatalogPart-Steuerelementen in einer CatalogZoneBase-Zone. Beispielsweise können Sie die CreateCatalogPartChromeStyle-Methode überschreiben, um einige spezifische Stilattribute anzupassen, die für die CatalogZoneBase-Zone übernommen werden.

Die CatalogPartChrome-Klasse enthält mehrere wichtige Methoden, die hilfreich beim Überschreiben des Renderings von CatalogPart-Steuerelementen sind. Zu diesen zählt der CatalogPartChrome-Konstruktor, mit dem Sie die CreateCatalogPartChrome-Methode in einer benutzerdefinierten CatalogZoneBase-Zone überschreiben können, um eine Instanz des benutzerdefinierten CatalogPartChrome-Objekts zu erstellen. Die RenderPartContents-Methode ist ebenfalls nützlich. Mit dieser Methode können Sie das Rendering des Inhaltsbereichs von Steuerelementen in einer Zone steuern (jedoch nicht das Rendering von Chromelementen wie Header, Footer und Titelleisten). Wenn alle Aspekte des Renderings der CatalogPart-Steuerelemente vollständig programmgesteuert sein sollen, können Sie die RenderCatalogPart-Methode überschreiben.

Hinweise zur Implementierung

Wenn Sie von der CatalogPartChrome-Klasse erben, müssen Sie eine benutzerdefinierte CatalogZone-Zone erstellen, um die benutzerdefinierte CatalogPartChrome-Klasse zurückzugeben. Im Beispielabschnitt der Übersicht für diese Klasse wird veranschaulicht, wie eine benutzerdefinierte CatalogZone-Zone erstellt wird, um eine benutzerdefinierte CatalogPartChrome-Klasse zurückzugeben.

Im folgenden Codebeispiel wird veranschaulicht, wie mit der CatalogPartChrome-Klasse das Standardrendering von CatalogPart-Steuerelementen in einer CatalogZoneBase-Zone überschrieben wird.

Das Codebeispiel besteht aus drei Teilen:

  • Ein Benutzersteuerelement, mit dessen Hilfe Sie die Anzeigemodi auf einer Webparts-Seite wechseln können.

  • Eine Webseite, die alle Steuerelemente im Beispiel hostet.

  • Eine Klasse, die den Quellcode für eine benutzerdefinierte CatalogPartChrome-Klasse und eine benutzerdefinierte CatalogZoneBase-Zone enthält.

Der erste Teil des Codebeispiels ist das Benutzersteuerelement. Der Quellcode für das Benutzersteuerelement stammt aus einem anderen Thema. Damit dieses Codebeispiel ausgeführt werden kann, müssen Sie die ASCX-Datei für das Benutzersteuerelement aus dem Thema Walkthrough: Changing Display Modes on a Web Parts Page abrufen und in dem Ordner ablegen, in dem sich die ASPX-Seite aus diesem Codebeispiel befindet.

Der zweite Teil des Beispiels ist die Webseite. Beachten Sie, dass eine Register-Direktive im oberen Bereich der Datei enthalten ist, mit der die kompilierte Komponente und ein Tagpräfix registriert wird. Beachten Sie zudem, dass die Seite über das Element <aspSample:MyCatalogZone> auf die benutzerdefinierte Katalogzone verweist.


<%@ 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>


Der dritte Teil des Beispiels enthält die Implementierung des benutzerdefinierten CatalogPart-Chroms und der CatalogPart-Zone. MyCatalogZone erweitert CatalogZone und überschreibt CreateCatalogPartChrome, um das benutzerdefinierte CatalogPart-Chrom zurückzugeben. MyCatalogPartChrome ändert die Hintergrundfarbe des Katalogsteuerelements in der CreateCatalogPartChromeStyle-Methode. Die Hintergrundfarbe der Zone wird in der PerformPreRender-Methode geändert, und dem CatalogPart in der RenderPartContents-Methode wird Text hinzugefügt.


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);
        }
    }
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft