Cette documentation est archivée et n’est pas conservée.

ToolZone, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Sert de classe de base pour un ensemble de zones d'assistance qui apparaissent uniquement dans certains modes d'affichage des pages associés.

Espace de noms : System.Web.UI.WebControls.WebParts
Assembly : System.Web (dans system.web.dll)

public abstract class ToolZone : WebZone, IPostBackEventHandler
public abstract class ToolZone extends WebZone implements IPostBackEventHandler
public abstract class ToolZone extends WebZone implements IPostBackEventHandler

Dans le jeu de contrôles WebPart, une zone est une région sur une page Web qui contient des contrôles serveur et fournit la disposition modulaire avec une interface utilisateur cohérente pour les contrôles qu'elle contient.

Il existe deux types généraux de contrôles de zones qui dérivent de la classe WebZone de base : les zones WebPartZoneBase et ToolZone. Les zones WebPartZoneBase contiennent des contrôles serveur (qui peuvent être des contrôles WebPart personnalisés ou d'autres contrôles serveur tels que les contrôles ASP.NET et les contrôles utilisateur). Ces contrôles forment l'interface utilisateur principale d'une page Web et sont visibles dans tous les modes d'affichage, sauf s'ils sont masqués par programme ou par un utilisateur.

Les zones ToolZone sont des zones d'assistance spéciales qui apparaissent uniquement lorsqu'une page utilise certains modes d'affichage associés à la zone. Ces zones contiennent également des contrôles serveur spéciaux qui permettent aux utilisateurs de modifier la disposition, l'apparence, les propriétés et le contenu des pages Web dans un navigateur. Les développeurs peuvent hériter de la classe ToolZone de base, ou de toute zone ToolZone dérivée, pour créer des zones personnalisées.

Le jeu de contrôles WebPart contient trois types de zones ToolZone, décrites dans le tableau suivant.

Type de zone outil

Description

EditorZone

Contient les contrôles utilisés pour modifier les propriétés WebPart et les propriétés de contrôles serveur sur une page.

CatalogZone

Contient les contrôles CatalogPart qui, à leur tour, contiennent les contrôles WebPart pouvant être ajoutés par les utilisateurs sur une page.

ConnectionsZone

Ne contient pas d'éléments de balisage déclaratifs ; cette zone est autonome. Au moment de l'exécution, elle restitue une interface utilisateur spéciale qui permet aux utilisateurs de gérer des connexions entre les contrôles WebPart.

La classe de base ToolZone fournit méthodes et les propriétés qui sont utiles aux zones dérivées. Elle contient les méthodes RenderHeader et RenderFooter, qui substituent les méthodes de base de la classe WebZone et restituent des boutons et d'autres attributs d'interface utilisateur pour l'en-tête et le pied de page d'une zone. Il existe également plusieurs membres pour la gestion des verbes, qui sont des actions d'interface courantes que les utilisateurs peuvent exécuter dans les différentes zones. Les membres liés à la gestion des verbes sont notamment : RenderVerb, RenderVerbs et HeaderCloseVerb.

ToolZone contient deux méthodes surchargées qui ajoutent les objets WebPartDisplayMode à la collection AssociatedDisplayModes. Cette collection de modes d'affichage associés détermine quels modes d'affichage sont relatifs à un type particulier de zone (en d'autres termes, il détermine dans quels modes d'affichage une zone est visible). L'union de tous les modes d'affichage associés pour toutes les zones ToolZone sur une page Web donnée détermine quels modes d'affichage (excepté le mode de navigation normal) peuvent être appliqués ou pris en charge sur la page. La collection des modes d'affichage pris en charge pour une page est contenue dans la propriété SupportedDisplayModes.

RemarqueRemarque

À un moment donné, un seul mode d'affichage peut être actif sur une page. Le mode d'affichage actuellement actif est référencé dans la propriété DisplayMode.

La classe ToolZone contient également plusieurs propriétés de style qui contiennent des attributs de style pour les différents éléments d'interface d'une zone. Certaines propriétés de style ToolZone incluent EditUIStyle, HeaderVerbStyle, InstructionTextStyle et LabelStyle.

Remarques à l'attention des héritiers Le jeu de contrôles WebPart contient les zones spécialisées répertoriées ci-dessus dans la section Notes, et vous pouvez souvent dériver l'un d'eux pour ajouter un comportement personnalisé à une zone. Toutefois, vous devez hériter directement de la classe ToolZone pour posséder plus de contrôle par programmation sur le rendu d'une zone. Par exemple, vous pouvez créer une zone personnalisée pour une tâche spécialisée, par exemple une zone de recherche. Pour créer une zone personnalisée, vous pouvez substituer chacun des membres ToolZone virtuels pour personnaliser complètement le rendu ou uniquement un membre particulier. Vous pouvez éventuellement créer aussi un mode d'affichage personnalisé pour votre zone en héritant de la classe WebPartDisplayMode, mais cela reste facultatif. Dans le constructeur de votre zone, vous devez ajouter à un objet WebPartDisplayModeCollection les différents modes d'affichage dans lesquels vous souhaitez que votre zone soit affichée, afin que votre zone soit visible lorsque la page utilise ces modes d'affichage.

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: