Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

WebPartManager.CatalogDisplayMode, champ

 

Représente le mode d'affichage utilisé pour l'ajout de contrôles serveur à une page Web à partir d'un catalogue de contrôles.Ce champ est en lecture seule.

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

public static readonly WebPartDisplayMode CatalogDisplayMode

Le champ CatalogDisplayMode fait référence à un objet WebPartDisplayMode personnalisé créé par et contenu dans le contrôle WebPartManager.Compte tenu qu'il s'agit d'un objet statique, vous pouvez y faire référence directement via la classe WebPartManager sans qu'une instance du contrôle ne soit nécessaire.

Lorsque les utilisateurs souhaitent ajouter des contrôles à une page, si un catalogue de contrôles serveur est disponible, ils peuvent faire basculer la page en CatalogDisplayMode (mode catalogue), et l'interface utilisateur de catalogue apparaît.L'interface utilisateur pour un catalogue WebPart est fournie par un contrôle de zone CatalogZoneBase.Les développeurs ajoutent cette zone à la page au moment du design, puis ajoutent des contrôles serveur à la zone, afin que les utilisateurs puissent ajouter ces contrôles à leurs pages au moment de l'exécution.Après que le développeur a ajouté ces contrôles, le mode catalogue devient un mode d'affichage pris en charge sur la page étant donné que les contrôles nécessaires y servent à activer le mode catalogue.

Lorsqu'un utilisateur fait basculer une page en mode catalogue, la zone et tous les contrôles serveur qui lui ont été ajoutés deviennent visibles et l'utilisateur peut sélectionner des contrôles du catalogue à ajouter à la page ou supprimer des contrôles de la page.Après que les contrôles ont été ajoutés à la page, ils apparaissent en mode de navigation normal et la page est mise à jour.

L'exemple de code suivant illustre l'utilisation du champ CatalogDisplayMode par programme.Le code remplit une liste déroulante avec les modes d'affichage pris en charge pour la page, qui sont, dans le cas présent, les modes navigation, design et catalogue.Le mode catalogue est disponible car l'élément <asp:CatalogZone> et ses éléments enfants se trouvent dans la page Web.Notez que, dans la méthode Page_PreRender, le code vérifie si la propriété DisplayMode actuelle a la valeur CatalogDisplayMode.Si tel est le cas, Label1 sera visible ; sinon, Label1 sera caché.

Après avoir chargé la page dans un navigateur, vous êtes en mode de navigation par défaut.Notez que l'étiquette sur la page est cachée.Utilisez le contrôle de liste déroulante pour faire basculer la page en mode catalogue.Notez que, du fait de la présence du code dans la méthode Page_PreRender, l'étiquette est à présent visible.Vous pouvez sélectionner le contrôle dans le catalogue et l'ajouter à l'une ou l'autre des deux zones sur la page.

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: