ToolZone-Klasse
Aktualisiert: November 2007
Dient als die Basisklasse für einen Satz von Hilfszonen, die nur in bestimmten zugeordneten Seitenanzeigemodi angezeigt werden.
Assembly: System.Web (in System.Web.dll)
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)] public abstract class ToolZone : WebZone, IPostBackEventHandler
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */ /** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */ public abstract class ToolZone extends WebZone implements IPostBackEventHandler
public abstract class ToolZone extends WebZone implements IPostBackEventHandler
<asp:ToolZone />
In einem Webparts-Steuerelementsatz stellt eine Zone eine Region auf einer Webseite dar, die Serversteuerelemente enthält, und für die enthaltenen Steuerelemente ein modulares Layout mit einer konsistenten Benutzeroberfläche bereitstellt.
Es gibt zwei allgemeine Zonentypen, die von der WebZone-Basisklasse ableitet werden: WebPartZoneBase-Zonen und ToolZone-Zonen. Die WebPartZoneBase-Zonen enthalten Serversteuerelemente (benutzerdefinierte WebPart-Steuerelemente oder andere Serversteuerelemente, darunter ASP.NET-Steuerelemente und Benutzersteuerelemente). Diese Steuerelemente bilden die primäre Benutzeroberfläche einer Webseite und sind in allen möglichen Anzeigemodi sichtbar, es sei denn, sie werden programmgesteuert oder von einem Benutzer ausgeblendet.
Bei den ToolZone-Zonen handelt es sich um spezielle Hilfszonen, die nur angezeigt werden, wenn sich eine Seite in bestimmten, der Zone zugeordneten Anzeigemodi befindet. Diese Zonen enthalten außerdem bestimmte Serversteuerelemente, die Benutzern ermöglichen, in einem Browser Änderungen an Layout, Darstellung, Eigenschaften und Inhalt von Webseiten vorzunehmen. Entwickler können die ToolZone-Basisklasse oder eine der abgeleiteten ToolZone-Zonen vererben, um benutzerdefinierte Zonen zu erstellen.
Der Webparts-Steuerelementsatz enthält drei Typen von ToolZone-Zonen, die in der folgenden Tabelle beschrieben werden.
Toolzonentyp | Beschreibung |
|---|---|
Enthält Steuerelemente, die zum Bearbeiten von WebPart und Serversteuerelement-Eigenschaften auf einer Seite verwendet werden. | |
Enthält CatalogPart-Steuerelemente, die wiederum WebPart-Steuerelemente enthalten, die Benutzer einer Seite hinzufügen können. | |
Enthält keine deklarativen Markupelemente; diese Zone ist unabhängig. Zur Laufzeit rendert sie eine spezielle Benutzeroberfläche, die Benutzern ermöglicht, Verbindungen zwischen WebPart-Steuerelementen zu verwalten. |
Die ToolZone-Basisklasse stellt Methoden und Eigenschaften bereit, die für abgeleitete Zonen hilfreich sein können. Sie enthält RenderHeader-Methoden und RenderFooter-Methoden, mit denen die Basismethoden der WebZone-Klasse überschrieben und sowohl Schaltflächen als auch andere Attribute der Benutzeroberfläche für den Header und Footer einer Zone dargestellt werden. Es gibt außerdem mehrere Member zum Behandeln von Verben, also häufiger UI-Aktionen, die Benutzer in den verschiedenen Zonen durchführen können. Zu den Membern zum Behandeln von Verben gehören: RenderVerb, RenderVerbs und HeaderCloseVerb.
Der ToolZone enthält zwei überladene Methoden, die der AssociatedDisplayModes-Auflistung WebPartDisplayMode-Objekte hinzufügen. Diese Auflistung zugeordneter Anzeigemodi bestimmt, welche Anzeigemodi mit einem bestimmten Zonentyp verknüpft werden (anders gesagt: sie bestimmt, in welchem Anzeigemodus eine Zone sichtbar ist). Die Union aller zugeordneten Anzeigemodi für alle ToolZone-Zonen auf einer angegebenen Webseite bestimmt, welche Anzeigemodi (neben dem normalen Durchsuchen-Modus) auf dieser Seite möglich sind oder von ihr unterstützt werden. Die Auflistung unterstützter Anzeigemodi für eine Seite ist in der SupportedDisplayModes-Eigenschaft enthalten.
 Hinweis: |
|---|
Zu einem beliebigen Zeitpunkt kann nur ein Anzeigemodus auf einer Seite aktiv sein. Auf den gegenwärtig aktiven Anzeigemodus wird in der DisplayMode-Eigenschaft verwiesen. |
Die ToolZone-Klasse enthält außerdem etliche Stileigenschaften, die wiederum Stilattribute für die verschiedenen UI-Elemente einer Zone enthalten. Zu einigen ToolZone-Stileigenschaften gehören EditUIStyle, HeaderVerbStyle, InstructionTextStyle und LabelStyle.
Hinweise zur Vererbung:Der Webparts-Steuerelementsatz enthält spezielle Zonen, die weiter oben im Abschnitt Hinweise beschrieben sind. Normalerweise können Sie von einer dieser Zonen die gewünschten Komponenten ableiten, um eine Zone benutzerdefiniert zu gestalten. Wenn Sie jedoch ein höheres Maß an programmgesteuerter Kontrolle über das Rendering einer Zone benötigen, sollten Sie die ToolZone-Klasse direkt vererben. Sie möchten beispielsweise eine benutzerdefinierte Zone für eine spezielle Aufgabe erstellen, z. B. eine Zone zum Durchsuchen.
Beim Erstellen einer benutzerdefinierten Zone können Sie einen beliebigen virtuellen ToolZone-Member überschreiben, um das Rendering vollständig anzupassen. Sie können auch nur einen bestimmten Member überschreiben. Optional können Sie auch einen benutzerdefinierten Anzeigemodus für die Zone erstellen, indem Sie die WebPartDisplayMode-Klasse vererben. Dies ist jedoch nicht zwingend erforderlich. Im Konstruktor der Zone sollten Sie die verschiedenen Anzeigemodi hinzufügen, in denen die Zone für ein WebPartDisplayModeCollection-Objekt angezeigt werden soll, sodass die Zone sichtbar ist, wenn sich die Seite in diesen Anzeigemodi befindet.
- AspNetHostingPermission
für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission
für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.CompositeControl
System.Web.UI.WebControls.WebParts.WebZone
System.Web.UI.WebControls.WebParts.ToolZone
System.Web.UI.WebControls.WebParts.CatalogZoneBase
System.Web.UI.WebControls.WebParts.ConnectionsZone
System.Web.UI.WebControls.WebParts.EditorZoneBase
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
