Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

WebPartManager, classe

Sert de classe centrale du jeu de contrôles WebPart, gérant tous les contrôles WebPart, les fonctionnalités et les événements qui se produisent sur une page Web.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebParts.WebPartManager

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

[BindableAttribute(false)]
public class WebPartManager : Control, 
	INamingContainer, IPersonalizable
<asp:WebPartManager />

Le type WebPartManager expose les membres suivants.

  NomDescription
Méthode publiqueWebPartManagerInitialise une nouvelle instance de la classe WebPartManager.
Début

  NomDescription
Propriété protégéeAdapterObtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueAvailableTransformersObtient une collection d'objets WebPartTransformer qui sont disponibles pour créer des connexions WebPart entre les contrôles serveur.
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.)
Propriété publiqueCloseProviderWarningObtient ou définit un avertissement qui s'affiche lorsqu'un utilisateur ferme un contrôle qui agit comme un fournisseur pour les autres contrôles d'une connexion.
Propriété publiqueConnectionsObtient une référence à la collection de toutes les connexions actives sur une page Web.
Propriété protégéeContextObtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publiqueControlsObtient la collection de tous les WebPart, contrôles serveur ou utilisateur contenus dans les zones WebPartZoneBase d'une page Web et gérés par le contrôle WebPartManager. (Substitue Control.Controls.)
Propriété publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publiqueDeleteWarningObtient ou définit un message d'avertissement personnalisé affiché à l'attention des utilisateurs finaux lorsqu'ils suppriment un contrôle.
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueDisplayModeObtient ou définit le mode d'affichage actif pour une page Web qui contient des contrôles WebPart.
Propriété publiqueDisplayModesObtient une collection en lecture seule de tous les modes d'affichage associés à un contrôle WebPartManager.
Propriété protégéeDynamicConnectionsObtient la collection de toutes les connexions dynamiques existant actuellement sur une page Web.
Propriété publiqueEnableClientScriptObtient ou définit une valeur qui détermine si le script côté client est activé sur la page Web qui contient un contrôle WebPartManager.
Propriété publiqueEnableThemingObtient une valeur indiquant que l'utilisation de thèmes est activée sur une page Web. (Substitue Control.EnableTheming.)
Propriété publiqueEnableViewStateObtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.)
Propriété protégéeEventsObtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété publiqueExportSensitiveDataWarningObtient ou définit le texte d'un message d'avertissement affiché lorsqu'un utilisateur tente d'exporter des données d'état sensibles d'un contrôle WebPart.
Propriété protégéeHasChildViewStateObtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.)
Propriété publiqueIDObtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégéeInternalsObtient une référence à la classe WebPartManagerInternals utilisée pour combiner et séparer un jeu de méthodes qui sont réellement implémentées dans la classe WebPartManager mais qui sont surtout utiles aux développeurs de contrôles.
Propriété protégéeIsChildControlStateClearedObtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
Propriété protégéeIsCustomPersonalizationStateDirtyObtient une valeur qui indique si les modifications de personnalisation apportées affectent les détails de personnalisation au niveau de la page contrôlés par le contrôle WebPartManager.
Propriété protégéeIsTrackingViewStateObtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégéeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégéeLoadViewStateByIDObtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.)
Propriété protégéeMediumPermissionSetObtient un objet PermissionSet qui autorise uniquement l'autorisation SecurityPermissionFlag.Execution et l'autorisation AspNetHostingPermissionLevel.Medium.
Propriété protégéeMinimalPermissionSetObtient un objet PermissionSet qui autorise uniquement l'autorisation SecurityPermissionFlag.Execution et l'autorisation AspNetHostingPermissionLevel.Minimal.
Propriété publiqueNamingContainerObtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control.ID possède la même valeur. (Hérité de Control.)
Propriété publiquePageObtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publiquePersonalizationObtient une référence à un objet qui contient des données de personnalisation pour une page Web.
Propriété publiqueRenderingCompatibilityObtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété publiqueSelectedWebPartObtient une référence à un WebPart ou un autre contrôle serveur actuellement sélectionné pour modifier ou pour créer une connexion avec un autre contrôle.
Propriété publiqueSiteObtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.)
Propriété publiqueSkinIDObtient ou définit une chaîne vide ("") de manière à ce qu'aucune apparence ne puisse être appliquée au contrôle WebPartManager. (Substitue Control.SkinID.)
Propriété publiqueStaticConnectionsObtient une référence à la collection de tous les objets WebPartConnection d'une page Web définis comme des connexions statiques.
Propriété publiqueSupportedDisplayModesObtient une collection en lecture seule de tous les modes d'affichage disponibles sur une page Web particulière.
Propriété publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publiqueUniqueIDObtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publiqueValidateRequestModeObtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control.)
Propriété protégéeViewStateObtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.)
Propriété protégéeViewStateIgnoresCaseObtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleObtient une valeur qui permet aux contrôles enfants d'être visibles. (Substitue Control.Visible.)
Propriété publiqueWebPartsObtient une référence à tous les contrôles WebPart suivis par le contrôle WebPartManager d'une page Web.
Propriété publiqueZonesObtient une référence à une collection de toutes les zones WebPartZoneBase d'une page Web.
Début

  NomDescription
Méthode protégéeActivateConnectionsRend actives toutes les connexions d'une page Web actuellement inactives.
Méthode protégéeAddedControlAppelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégéeAddParsedSubObjectAvertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publiqueAddWebPartFournit la méthode par programme standard pour ajouter des contrôles WebPart à une page Web.
Méthode publiqueApplyStyleSheetSkinApplique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.)
Méthode protégéeBeginRenderTracingCommence le traçage au moment du design des données de rendu. (Hérité de Control.)
Méthode publiqueBeginWebPartConnectingDémarre le processus de connexion de deux contrôles WebPart.
Méthode publiqueBeginWebPartEditingDémarre le processus d'édition d'un contrôle WebPart.
Méthode protégéeBuildProfileTreeInfrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode publiqueCanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)Vérifie les contrôles WebPart qui participeront à une connexion afin de déterminer s'ils peuvent être connectés lorsque les contrôles consommateur et fournisseur ont des interfaces compatibles et qu'un objet WebPartTransformer n'est pas nécessaire.
Méthode publiqueCanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)Vérifie les contrôles WebPart qui participeront à une connexion afin de déterminer s'ils peuvent être connectés, et utilise un objet WebPartTransformer pour créer la connexion entre un consommateur et un fournisseur incompatibles.
Méthode protégéeCheckRenderClientScriptVérifie les fonctionnalités du navigateur qui effectue la demande et la valeur de la propriété EnableClientScript, afin de déterminer s'il faut ou non restituer le script client.
Méthode protégéeClearCachedClientIDInfrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildViewStateSupprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.)
Méthode publiqueCloseWebPartFerme un contrôle WebPart de façon telle qu'il n'est pas restitué sur une page Web, mais qu'il peut être rouvert.
Méthode publiqueConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)Crée une connexion entre deux contrôles WebPart ou GenericWebPart en utilisant uniquement les références aux contrôles et leurs objets ConnectionPoint spécifiés.
Méthode publiqueConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)Crée une connexion entre deux contrôles WebPart ou GenericWebPart à l'aide des références aux contrôles, de leurs objets ConnectionPoint spécifiés et d'un objet WebPartTransformer.
Méthode protégéeCopyWebPartUtilisé par le jeu de composants WebPart pour créer une copie d'un WebPart ou d'un contrôle serveur en vue d'ajouter le contrôle à une page Web.
Méthode protégéeCreateAvailableTransformersCrée un jeu de transformateurs spécifié dans le fichier de configuration d'un site Web et l'ajoute à la collection de transformateurs référencée par la propriété AvailableTransformers.
Méthode protégéeCreateChildControlsAppelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.)
Méthode protégéeCreateControlCollectionRetourne la collection de tous les contrôles gérés par le contrôle WebPartManager sur une page Web. Cette classe ne peut pas être héritée. (Substitue Control.CreateControlCollection().)
Méthode protégéeCreateDisplayModesCrée le jeu de tous les modes d'affichage possibles pour une application WebPart.
Méthode protégéeCreateDynamicConnectionIDObtient une valeur unique pour servir d'ID pour une connexion dynamique.
Méthode protégéeCreateDynamicWebPartIDGénère un ID unique pour un contrôle WebPart dynamique.
Méthode protégéeCreateErrorWebPartCrée un contrôle spécial qui est inséré dans une page et affiché à l'attention des utilisateurs finaux lorsqu'une tentative de chargement ou de création d'un contrôle WebPart dynamique échoue pour une raison quelconque.
Méthode protégéeCreatePersonalizationRetourne un objet de personnalisation pour contenir les données de personnalisation d'un utilisateur pour la page Web en cours.
Méthode publiqueCreateWebPartEncapsule un contrôle serveur qui n'est pas un contrôle WebPart avec un objet GenericWebPart, de manière à ce que le contrôle puisse avoir les fonctionnalités WebPart.
Méthode publiqueDataBind()Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
Méthode protégéeDataBind(Boolean)Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.)
Méthode protégéeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDeleteWebPartSupprime définitivement une instance dynamique d'un contrôle WebPart d'une page Web.
Méthode protégéeDisconnectWebPartSupprime un WebPart ou un contrôle serveur qui est fermé ou supprimé de toutes les connexions auxquelles il participe.
Méthode publiqueDisconnectWebPartsExécute le processus de déconnexion des contrôles serveur connectés sur une page Web.
Méthode publiqueDisposePermet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingMet fin au traçage au moment du design des données de rendu. (Hérité de Control.)
Méthode publiqueEndWebPartConnectingExécute le processus de connexion d'un contrôle WebPart à un autre contrôle.
Méthode publiqueEndWebPartEditingMet fin au processus de modification d'un contrôle WebPart.
Méthode protégéeEnsureChildControlsDétermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.)
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueExportWebPartCrée un fichier de description XML qui contient les données d'état et de propriété du contrôle serveur.
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(String)Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control.)
Méthode protégéeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.)
Méthode publiqueFocusSubstitué pour empêcher le focus d'être défini sur le contrôle WebPartManager, compte tenu qu'il n'a pas d'interface utilisateur. (Substitue Control.Focus().)
Méthode publiqueGetConsumerConnectionPointsRécupère la collection d'objets ConsumerConnectionPoint qui peuvent agir comme des points de connexion d'un contrôle serveur qui joue le rôle de consommateur dans une connexion WebPart.
Méthode publiqueMembre statiqueGetCurrentWebPartManagerRécupère une référence à l'instance actuelle du contrôle WebPartManager sur une page.
Méthode protégéeGetDesignModeStateInfrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode protégéeGetDisplayTitleObtient une chaîne contenant la valeur de la propriété DisplayTitle d'un contrôle WebPart.
Méthode publiqueGetExportUrlObtient le chemin d'accès virtuel relatif et la chaîne de requête qui font partie de la demande lorsqu'un utilisateur tente d'exporter un contrôle WebPart.
Méthode publiqueGetGenericWebPartObtient une référence à l'instance du contrôle GenericWebPart qui contient un contrôle serveur.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetProviderConnectionPointsRécupère la collection d'objets ProviderConnectionPoint qui peuvent agir comme des points de connexion d'un contrôle serveur qui joue le rôle de fournisseur dans une connexion WebPart.
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode publiqueImportWebPartImporte un fichier de description XML qui contient les données d'état et de propriété du contrôle WebPart et applique les données au contrôle.
Méthode publiqueIsAuthorized(WebPart)Exécute les étapes initiales en déterminant si l'ajout d'un contrôle à une page est autorisé.
Méthode publiqueIsAuthorized(Type, String, String, Boolean)Exécute les étapes finales en déterminant si l'ajout d'un contrôle à une page est autorisé.
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateCharge les données d'état du contrôle qui ont été enregistrées par une demande de page antérieure et doivent être restaurées sur une demande ultérieure. (Substitue Control.LoadControlState(Object).)
Méthode protégéeLoadCustomPersonalizationStateEnregistre les données de personnalisation personnalisées qui ont été passées au contrôle WebPartManager par les objets de personnalisation à utiliser ultérieurement pendant le processus d'initialisation.
Méthode protégéeLoadViewStateRestaure les informations d'état d'affichage à partir d'une demande de page antérieure enregistrée par la méthode SaveViewState. (Hérité de Control.)
Méthode protégéeMapPathSecureRécupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMoveWebPartDéplace un WebPart ou contrôle serveur d'une zone WebPartZoneBase à l'autre ou à une nouvelle position dans la même zone.
Méthode protégéeOnAuthorizeWebPartDéclenche l'événement AuthorizeWebPart et appelle un gestionnaire pour l'événement, le cas échéant.
Méthode protégéeOnBubbleEventDétermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnConnectionsActivatedDéclenche l'événement ConnectionsActivated pour indiquer qu'une page et ses contrôles sont chargés, et que les connexions sur la page ont été activées pour commencer le partage des données.
Méthode protégéeOnConnectionsActivatingDéclenche l'événement ConnectionsActivating pour indiquer qu'une page et ses contrôles ont été chargés et que le processus d'activation des connexions peut commencer.
Méthode protégéeOnDataBindingDéclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégéeOnDisplayModeChangedDéclenche l'événement DisplayModeChanged pour indiquer que le contrôle WebPartManager a terminé le processus de basculement d'un mode d'affichage à l'autre sur une page Web.
Méthode protégéeOnDisplayModeChangingDéclenche l'événement DisplayModeChanging pour indiquer que le contrôle WebPartManager est en train de basculer d'un mode d'affichage à l'autre sur une page Web.
Méthode protégéeOnInitDéclenche l'événement Init qui est le premier événement dans le cycle de vie du contrôle WebPartManager. (Substitue Control.OnInit(EventArgs).)
Méthode protégéeOnLoadDéclenche l'événement Load. (Hérité de Control.)
Méthode protégéeOnPreRenderDéclenche l'événement PreRender qui se produit juste avant qu'un contrôle WebPartManager ne soit rendu sur une page Web. (Substitue Control.OnPreRender(EventArgs).)
Méthode protégéeOnSelectedWebPartChangedDéclenche l'événement SelectedWebPartChanged, qui se produit après qu'un contrôle WebPart a été récemment sélectionné ou dont la sélection a fait l'objet d'une suppression.
Méthode protégéeOnSelectedWebPartChangingDéclenche l'événement SelectedWebPartChanging qui se produit pendant le processus de changement du contrôle WebPart actuellement sélectionné.
Méthode protégéeOnUnloadDéclenche l'événement Unload de base et supprime l'instance de WebPartManager d'une page Web. (Substitue Control.OnUnload(EventArgs).)
Méthode protégéeOnWebPartAddedDéclenche l'événement WebPartAdded qui se produit après qu'un contrôle WebPart a été ajouté à une page.
Méthode protégéeOnWebPartAddingDéclenche l'événement WebPartAdding qui se produit au cours du processus d'ajout d'un contrôle WebPart (ou d'un contrôle serveur ou utilisateur) à une zone WebPartZoneBase.
Méthode protégéeOnWebPartClosedDéclenche l'événement WebPartClosed pour signaler qu'un contrôle a été supprimé d'une page.
Méthode protégéeOnWebPartClosingDéclenche l'événement WebPartClosing qui se produit au cours du traitement d'un WebPart ou d'un contrôle serveur supprimé d'une page.
Méthode protégéeOnWebPartDeletedDéclenche l'événement WebPartDeleted qui se produit après qu'un contrôle WebPart a été supprimé définitivement d'une page.
Méthode protégéeOnWebPartDeletingDéclenche l'événement WebPartDeleting qui indique qu'un contrôle WebPart dynamique (ou contrôle serveur ou utilisateur contenu dans une zone WebPartZoneBase) est en cours de suppression.
Méthode protégéeOnWebPartMovedDéclenche l'événement WebPartMoved qui se produit après qu'un contrôle WebPart a été déplacé à un emplacement différent sur une page.
Méthode protégéeOnWebPartMovingDéclenche l'événement WebPartMoving qui indique qu'un WebPart ou un contrôle serveur ou utilisateur dans une zone WebPartZoneBase est en cours de déplacement.
Méthode protégéeOnWebPartsConnectedDéclenche l'événement WebPartsConnected qui se produit après qu'une connexion a été établie entre des contrôles WebPart.
Méthode protégéeOnWebPartsConnectingDéclenche l'événement WebPartsConnecting qui se produit au cours du processus d'établissement d'une connexion entre deux WebPart ou contrôles serveur ou utilisateur contenus dans une zone WebPartZoneBase.
Méthode protégéeOnWebPartsDisconnectedDéclenche l'événement WebPartsDisconnected qui se produit après qu'une connexion entre contrôles WebPart a pris fin.
Méthode protégéeOnWebPartsDisconnectingDéclenche l'événement WebPartsDisconnecting qui indique que deux WebPart ou contrôles serveur ou utilisateur dans une zone WebPartZoneBase sont en cours de clôture de connexion.
Méthode protégéeOpenFileObtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéeRaiseBubbleEventAssigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRegisterClientScriptAutorise le contrôle WebPartManager à émettre un script côté client utilisé pour diverses fonctionnalités de personnalisation, telles que le glisser-déplacer de contrôles WebPart dans une page Web.
Méthode protégéeRemovedControlAppelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégéeRenderSubstitué pour empêcher le contrôle WebPartManager de rendre du contenu. (Substitue Control.Render(HtmlTextWriter).)
Méthode protégéeRenderChildrenRenvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
Méthode publiqueRenderControl(HtmlTextWriter)Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de Control.)
Méthode protégéeRenderControl(HtmlTextWriter, ControlAdapter)Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.)
Méthode protégéeResolveAdapterObtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre les données d'état du contrôle WebPartManager de manière à ce que les données puissent être restaurées sur demande ultérieure à la page Web qui contient le contrôle. (Substitue Control.SaveControlState().)
Méthode protégéeSaveCustomPersonalizationStateEnregistre les données d'état de personnalisation personnalisées conservées dans le contrôle WebPartManager, de manière à ce que ces données puissent être rechargées à chaque fois que la page est rechargée.
Méthode protégéeSaveViewStateEnregistre les modifications éventuellement apportées à l'état d'affichage du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.)
Méthode protégéeSetDesignModeStateDéfinit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode protégéeSetPersonalizationDirtyDéfinit un indicateur qui signale que les données de personnalisation personnalisées du contrôle WebPartManager ont été modifiées.
Méthode publiqueSetRenderMethodDelegateInfrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.)
Méthode protégéeSetSelectedWebPartDéfinit la valeur de propriété SelectedWebPart égale au WebPart actuellement sélectionné ou au contrôle serveur.
Méthode publiqueSetTraceData(Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeTrackViewStateApplique les données d'état de personnalisation au contrôle WebPartManager et appelle la méthode de base pour activer le suivi des modifications apportées aux données d'état d'affichage du contrôle. (Substitue Control.TrackViewState().)
Début

  NomDescription
Événement publicAuthorizeWebPartSe produit lorsque la méthode IsAuthorized est appelée pour déterminer si un WebPart ou contrôle serveur peut être ajouté à une page.
Événement publicConnectionsActivatedSe produit après que toutes les connexions WebPart actuelles d'une page sont non seulement connectées, mais ont commencé activement à partager les données entre les contrôles consommateur et fournisseur impliqués dans chaque connexion.
Événement publicConnectionsActivatingSe produit au cours du processus d'activation de toutes les connexions WebPart établies sur une page Web.
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDisplayModeChangedSe produit après que le mode d'affichage actuel sur une page WebPart a été modifié.
Événement publicDisplayModeChangingSe produit après qu'un utilisateur a cliqué sur un verbe dans une page Web, ce qui lance le processus de passage à un mode d'affichage différent.
Événement publicDisposedSe produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.)
Événement publicInitSe produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.)
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement publicPreRenderSe produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement publicSelectedWebPartChangedSe produit après que la sélection d'un contrôle WebPart a été modifiée et déplacée vers un autre contrôle d'une page Web.
Événement publicSelectedWebPartChangingSe produit au cours du processus de modification du WebPart ou contrôle serveur actuellement sélectionné sur une page Web.
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Événement publicWebPartAddedSe produit après qu'un WebPart dynamique ou autre contrôle serveur a été ajouté à une zone WebPartZoneBase, pour indiquer que le contrôle a été ajouté avec succès.
Événement publicWebPartAddingSe produit pendant le processus d'ajout d'un WebPart dynamique ou d'un autre contrôle serveur à une zone WebPartZoneBase.
Événement publicWebPartClosedSe produit lorsqu'un contrôle WebPart (ou un contrôle serveur ou utilisateur) est supprimé d'une page.
Événement publicWebPartClosingSe produit au cours du processus de suppression d'un contrôle WebPart (ou d'un contrôle serveur ou utilisateur) d'une page.
Événement publicWebPartDeletedSe produit après qu'un WebPart ou autre contrôle serveur a été supprimé d'une zone WebPartZoneBase.
Événement publicWebPartDeletingSe produit au cours du processus de suppression définitive d'une instance d'un WebPart dynamique ou d'un autre contrôle serveur d'une zone WebPartZoneBase.
Événement publicWebPartMovedSe produit après qu'un WebPart ou contrôle serveur a été déplacé vers un emplacement différent sur une page Web.
Événement publicWebPartMovingSe produit au cours du processus de déplacement d'un WebPart ou d'un autre contrôle serveur contenu dans une zone WebPartZoneBase.
Événement publicWebPartsConnectedSe produit après qu'une connexion spécifique a été établie entre des contrôles WebPart (ou contrôles serveur ou utilisateur).
Événement publicWebPartsConnectingSe produit au cours du processus de création d'une connexion entre les contrôles WebPart (ou les contrôles serveur ou utilisateur placés dans une zone WebPartZoneBase).
Événement publicWebPartsDisconnectedSe produit après qu'il a été mis fin à une connexion entre deux WebPart ou contrôles serveur.
Événement publicWebPartsDisconnectingSe produit au cours du processus de clôture de connexion entre des WebPart ou contrôles serveur précédemment connectés.
Début

  NomDescription
Méthode d'extension publiqueEnableDynamicData(Type)Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publiqueEnableDynamicData(Type, Object)Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publiqueEnableDynamicData(Type, IDictionary<String, Object>)Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publiqueFindDataSourceControlRetourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindFieldTemplateRetourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueGetDefaultValuesObtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueGetMetaTableObtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueSetMetaTable(MetaTable)Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueSetMetaTable(MetaTable, IDictionary<String, Object>)Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueSetMetaTable(MetaTable, Object)Surchargé. Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueTryGetMetaTableDétermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début

  NomDescription
Champ publicMembre statiqueBrowseDisplayModeReprésente le mode d'affichage par défaut pour les pages qui contiennent des contrôles WebPart. Ce champ est en lecture seule.
Champ publicMembre statiqueCatalogDisplayModeRepré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.
Champ publicMembre statiqueConnectDisplayModeReprésente le mode d'affichage utilisé pour afficher une interface utilisateur spéciale afin que les utilisateurs puissent gérer les connexions entre les contrôles WebPart. Ce champ est en lecture seule.
Champ publicMembre statiqueDesignDisplayModeReprésente le mode d'affichage utilisé pour modifier la disposition des pages Web qui contiennent des contrôles WebPart. Ce champ est en lecture seule.
Champ publicMembre statiqueEditDisplayModeReprésente le mode d'affichage dans lequel les utilisateurs finaux peuvent éditer et modifier les contrôles serveur. Ce champ est en lecture seule.
Début

  NomDescription
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIPersonalizable.IsDirtyObtient une valeur qui indique si les données d'état de personnalisation personnalisées gérées par le contrôle WebPartManager ont été modifiées sur une page Web.
Implémentation d'interface expliciteMéthode privéeIPersonalizable.LoadRetourne les données d'état de personnalisation personnalisées précédemment enregistrées qui doivent être chargées dans le contrôle WebPartManager.
Implémentation d'interface expliciteMéthode privéeIPersonalizable.SaveEnregistre les données d'état de personnalisation personnalisées qui sont gérées par le contrôle WebPartManager.
Début

Le contrôle WebPartManager agit en tant que pivot ou le centre de contrôle d'une application WebPart. Il ne doit y avoir qu'une et une seule instance de contrôle WebPartManager sur chaque page qui utilise des contrôles WebPart. Comme avec la plupart des aspects des applications WebPart, le contrôle WebPartManager est uniquement utilisé avec des utilisateurs authentifiés. En outre, ses fonctionnalités fonctionnent presque entièrement avec des contrôles serveur qui résident dans les zones WebPart qui héritent de la classe WebZone. Les serveurs contrôle qui résident sur une page en dehors de ces zones peut avoir des fonctionnalités WebPart très réduites ou une interaction avec le contrôle WebPartManager.

À l'instar du concentrateur pour fonctionnalités WebPart sur une page, le contrôle WebPartManager exécute les types de tâches décrits dans le tableau suivant.

Catégorie de tâche

Fonction du contrôle

Suivi de contrôles WebPart

Assure le suivi des différents types de contrôles sur une page qui fournissent des fonctionnalités WebPart, notamment les contrôles, connexions, zones WebPart et autres.

Ajout et suppression de contrôles WebPart

Fournit les méthodes pour ajouter, supprimer et fermer des contrôles WebPart sur une page.

Administration des connexions

Crée des connexions entre les contrôles et surveille les connexions ainsi que les processus d'ajout et de suppression de celles-ci.

Personnalisation des contrôles et des pages

Permet aux utilisateurs de déplacer les contrôles vers différents emplacements sur une page et lance les vues dans lesquelles les utilisateurs peuvent modifier l'apparence, les propriétés et le comportement des contrôles. Gère les paramètres de personnalisation spécifiques à l'utilisateur sur chaque page.

Basculement entre différents affichages de page

Fait basculer une page d'un affichage spécialisé à l'autre, de manière à ce que les utilisateurs puissent exécuter certaines tâches telles que modifier la mise en page ou modifier les contrôles.

Déclenchement d'événements du cycle de vie des WebParts

Définit, déclenche et permet aux développeurs de gérer les événements de cycle de vie de contrôles WebPart, notamment lorsque des contrôles sont ajoutés, déplacés, connectés ou supprimés.

Activation de l'importation et de l'exportation des contrôles

Exporte les flux XML qui contiennent l'état des propriétés de contrôles WebPart et permet aux utilisateurs d'importer les fichiers pour faciliter la personnalisation de contrôles complexes dans d'autres pages ou sites.

La classe WebPartManager a un jeu de propriétés étendu. Cohérente avec le rôle WebPartManager de suivi d'autres contrôles, elle présente un certain nombre de propriétés qui font référence à des collections de contrôles WebPart ou d'autres objets WebPart spéciaux. Les propriétés AvailableTransformers, Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebParts et Zones sont toutes des collections utilisées par le contrôle WebPartManager pour son suivi et d'autres tâches de gestion.

Un autre groupe de propriétés contient des avertissements personnalisables qui s'appliquent dans certains scénarios qui se produisent dans une application WebPart. Il s'agit notamment des propriétés CloseProviderWarning, DeleteWarning et ExportSensitiveDataWarning.

La classe WebPartManager substitue certaines propriétés de base héritées qui sont utilisées par un grand nombre de contrôles serveur Web. Il s'agit notamment des propriétés EnableTheming, SkinID et Visible.

Enfin, il existe un groupe de propriétés utile pour accéder à l'état actuel de l'application. La propriété DisplayMode indique le mode d'affichage actuel d'une page. La propriété EnableClientScript indique si un contrôle est autorisé à restituer un script côté client, qui est pertinent dans les situations où les utilisateurs peuvent avoir des navigateurs avec les fonctions différentes ou avoir désactivé les scripts. La propriété Internals est utile pour faire référence à une classe utilitaire qui contient les appels à plusieurs méthodes WebPart importantes utilisées pour les cas d'extensibilité. En masquant les appels à ces méthodes dans une classe séparée (la classe WebPartManagerInternals), la propre API de la classe WebPartManager est simplifiée. La propriété Personalization fournit l'accès aux objets de personnalisation qui enregistrent les paramètres de personnalisation des utilisateurs et rendent ces données persistantes dans un stockage permanent. La propriété SelectedWebPart indique le contrôle WebPart actuellement sélectionné sur une page par l'utilisateur ou l'application. La propriété IPersonalizable.IsDirty indique si les données de personnalisation personnalisées sur un contrôle WebPart ont changé.

Le contrôle WebPartManager contient cinq modes d'affichage intégrés ou vues d'une page Web. Les développeurs peuvent étendre cette fonctionnalité en créant des modes d'affichage personnalisés en étendant des types tels que la classe WebZone ou la classe ToolZone. Les utilisateurs peuvent basculer une page d'un mode d'affichage à l'autre, à condition que le type de contrôle approprié qui correspond à un mode d'affichage donné soit présent sur une page.

RemarqueRemarque

Il est possible d'étendre cette fonctionnalité de manière à ce que les utilisateurs puissent basculer dans un mode d'affichage personnalisé sans avoir de zone correspondante sur la page. Toutefois, le comportement par défaut est que les modes d'affichage correspondent à des zones.

Les modes d'affichage standard sont représentés par les champs publics dans la classe WebPartManager. Le tableau suivant résume les champs et les modes d'affichage auxquels ils font référence. Le mode d'affichage actuel d'une page, comme indiqué plus haut, est toujours référencé dans la propriété DisplayMode et le jeu de modes d'affichage possible sur une page particulière, compte tenu du type de zones présentes sur la page, est contenu dans la propriété SupportedDisplayModes.

Champ

Détails relatifs au mode d'affichage

BrowseDisplayMode

Affichage utilisateur normal d'une page Web ; mode d'affichage par défaut et le plus courant.

DesignDisplayMode

Affichage dans lequel les utilisateurs peuvent réorganiser ou supprimer des contrôles pour modifier la mise en page.

EditDisplayMode

Affichage dans lequel une interface utilisateur de modification devient visible ; les utilisateurs peuvent modifier l'apparence, les propriétés et le comportement des contrôles visibles dans le mode de navigation normal.

CatalogDisplayMode

Affichage dans lequel une interface utilisateur de catalogue devient visible ; les utilisateurs peuvent ajouter des contrôles à une page à partir de catalogues de contrôles disponibles.

ConnectDisplayMode

Affichage dans lequel une interface utilisateur de connexion devient visible ; les utilisateurs peuvent connecter, gérer ou déconnecter des connexions entre les contrôles.

Le contrôle WebPartManager contient également un certain nombre d'événements critiques dans le cycle de vie de pages et de contrôles WebPart. Ces événements fournissent un contrôle par programmation précis sur le comportement de contrôles WebPart. La plupart des méthodes se rapportent directement aux contrôles WebPart (ou autres contrôles serveur ou utilisateur placés dans des zones WebPartZoneBase afin qu'ils puissent se comporter comme des contrôles WebPart). Toutefois, quelques événements se rapportent à l'état de la page ou des connexions sur la page. Le tableau suivant répertorie les événements disponibles et résume leurs fonctions.

RemarqueRemarque

Dans le tableau suivant, toutes les occurrences du mot « contrôle » font référence à un contrôle WebPart ou à tout contrôle serveur qui réside dans une zone et qui est encapsulé avec un objet GenericWebPart au moment de l'exécution.

Événement

Description

AuthorizeWebPart

Se produit juste avant qu'un contrôle ne soit ajouté à une page pour vérifier qu'il est autorisé.

ConnectionsActivated

Se produit après que toutes les connexions sur une page ont été activées.

ConnectionsActivating

Se produit juste avant le processus d'activation de toutes les connexions sur une page.

DisplayModeChanged

Se produit après que le mode d'affichage actuel d'une page a changé.

DisplayModeChanging

Se produit juste avant le processus de modification du mode d'affichage d'une page.

SelectedWebPartChanged

Se produit après que la sélection d'un contrôle a été annulée.

SelectedWebPartChanging

Se produit juste avant le processus d'annulation de la sélection d'un contrôle.

WebPartAdded

Se produit après qu'un contrôle a été ajouté à une zone.

WebPartAdding

Se produit juste avant le processus d'ajout d'un contrôle à une zone.

WebPartClosed

Se produit après qu'un contrôle a été fermé (supprimé d'une page).

WebPartClosing

Se produit juste avant le processus de fermeture d'un contrôle.

WebPartDeleted

Se produit après qu'une instance d'un contrôle dynamique (créé par programme ou ajouté à partir d'un catalogue) a été supprimée définitivement.

WebPartDeleting

Se produit juste avant le processus de suppression d'un contrôle dynamique.

WebPartMoved

Se produit après qu'un contrôle a été déplacé dans sa zone ou vers une autre zone.

WebPartMoving

Se produit juste avant le processus de déplacement d'un contrôle.

WebPartsConnected

Se produit après que deux contrôles sélectionnés pour participer à une connexion ont établi la connexion.

WebPartsConnecting

Se produit juste avant le processus de connexion de deux contrôles.

WebPartsDisconnected

Se produit après que deux contrôles connectés ont été déconnectés.

WebPartsDisconnecting

Se produit juste avant le processus de déconnexion de deux contrôles.

Le contrôle WebPartManager dispose de nombreuses méthodes pour gérer les pages WebPart. Un jeu étendu de méthodes, non répertoriées ici, rassemble les méthodes dont les noms prennent la forme OnEventName. Ces méthodes déclenchent généralement leur événement associé et fournissent à l'événement un gestionnaire de type WebPartEventHandler. La plupart de ces méthodes peuvent être substituées par les développeurs qui héritent de la classe WebPartManager. De même, les développeurs de pages peuvent fournir des gestionnaires personnalisés pour les événements associés à ces méthodes. Par exemple, dans le cas de l'événement WebPartAdded, un développeur de pages peut ajouter un attribut OnWebPartAdded à l'élément <asp:webpartmanager> dans le balisage d'une page Web, puis assigner un nom de méthode personnalisé à l'attribut pour fournir un gestionnaire personnalisé pour l'événement. L'attribut correspond à la méthode OnWebPartAdded, et ce modèle de base de gestion d'événements fonctionne pour la plupart des événements WebPart et leurs méthodes associées.

En outre, le contrôle WebPartManager dispose de méthodes particulières à la tâche de gestion de contrôles WebPart (et contrôles serveur ou utilisateur utilisés comme des contrôles WebPart). Il s'agit notamment des méthodes AddWebPart, AuthorizeWebPart, CloseWebPart, CopyWebPart, CreateWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPart, GetGenericWebPart, ImportWebPart, IsAuthorized et MoveWebPart.

Un autre jeu de méthodes est spécialisé pour les connexions. Il s'agit notamment des méthodes ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnecting, GetConsumerConnectionPoints et GetProviderConnectionPoints.

Enfin, certaines méthodes WebPartManager se focalisent sur les fonctionnalités de personnalisation. Il s'agit notamment de CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save et SaveControlState.

Pour plus d'informations sur les autres méthodes WebPartManager accessibles via la propriété Internals, consultez la documentation relative à la classe WebPartManagerInternals.

Remarques à l'attention des héritiers

Le contrôle WebPartManager est conçu pour être étendu. Compte tenu qu'il joue un rôle central dans les applications WebPart, si vous souhaitez étendre un type ou un contrôle spécifique dans le jeu de composants WebPart, vous devrez bien souvent étendre aussi la classe WebPartManager car il est probable qu'une propriété ou une méthode soit requise pour que votre type personnalisé puisse fonctionner dans le contexte d'une application WebPart. La documentation de référence WebPart (voir System.Web.UI.WebControls.WebParts) en ce qui concerne l'extension d'un type WebPart mentionne à plusieurs reprises comment procéder pour étendre également la classe WebPartManager ou indique comment l'étendre dans un exemple de code.

TopicLocation
Comment : déclarer une connexion statique entre deux contrôles WebPartGénération d'applications Web ASP.NET dans Visual Studio
Comment : désactiver la personnalisation des WebPartsGénération d'applications Web ASP.NET dans Visual Studio
Comment : déclarer une connexion statique entre deux contrôles WebPartGénération d'applications Web ASP.NET
Comment : désactiver la personnalisation des WebPartsGénération d'applications Web ASP.NET
Comment : déclarer une connexion statique entre deux contrôles WebPartGénération d'applications Web ASP.NET dans Visual Studio
Comment : désactiver la personnalisation des WebPartsGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant illustre l'utilisation déclarative et par programme du contrôle WebPartManager.

L'exemple de code est composé de quatre parties :

  • Contrôle utilisateur qui vous permet de modifier les modes d'affichage d'une page WebPart.

  • Une page Web qui contient deux contrôles WebPart personnalisés qui peuvent être connectés, et un élément <asp:webpartmanager>.

  • Un fichier de code source qui contient deux contrôles WebPart personnalisés et une interface personnalisée.

  • Explication du fonctionnement de l'exemple dans un navigateur.

Le contrôle utilisateur a un contrôle de liste déroulante qui affiche les modes d'affichage possibles sur une page, compte tenu des contrôles WebPart présents sur la page. Dans la page Web de cet exemple de code, ce contrôle utilisateur est déclaré juste au-dessous de l'élément WebPartManager dans le balisage de la page et une directive Register placée vers le haut de la page Web permet d'enregistrer le contrôle. Pour plus d'informations sur les modes d'affichage et une description du code source dans ce contrôle, consultez Walkthrough: Changing Display Modes on a Web Parts Page.


<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">

 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }

  }

  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>


La balise déclarative pour la page Web contient des directives Register pour le contrôle utilisateur et pour les contrôles personnalisés. On peut citer un élément <asp:webpartmanager>, un élément <asp:webpartzone> pour contenir les contrôles personnalisés, ainsi qu'un élément <asp:connectionszone>. La page contient également du code incorporé qui gère les événements relatifs à la connexion pour le contrôle WebPartManager ; vous pouvez voir l'effet de ce code en connectant et en déconnectant les contrôles.


<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  private void UpdateLabelData(int wpCount, int connCount)
  {
    Label1.Text = "WebPart Control Count:  " + wpCount.ToString();
    Label2.Text = "Connections Count: " + connCount.ToString();
  }

  protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

  protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
        OnWebPartsConnected="WebPartManager1_WebPartsConnected" 
        OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>


La troisième partie de l'exemple correspond au code source des contrôles. Notez la présence d'une interface nommée IZipCode ; cette interface est implémentée dans la classe ZipCodeWebPart. Cette classe a une méthode spéciale de rappel nommée ProvideIZipCode, qui sert de fournisseur. L'autre type, nommé WeatherWebPart, est également implémenté avec une méthode spéciale nommée GetIZipCode, qui permet au contrôle d'agir comme consommateur de l'autre contrôle.

Pour exécuter l'exemple de code, vous devez compiler ce code source. Vous pouvez le compiler explicitement et mettre l'assembly résultant dans le dossier Bin de votre site Web ou dans le Global Assembly Cache. Vous pouvez également mettre le code source dans le dossier App_Code de votre site où il sera compilé dynamiquement au moment de l'exécution. Cet exemple de code suppose que vous avez compilé la source dans un assembly, et la directive Register qui se trouve dans la page Web fait référence au nom de l'assembly. Pour obtenir une procédure pas à pas qui illustre le processus de compilation, consultez Walkthrough: Developing and Using a Custom Server Control.


namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (input.Text != String.Empty)
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }

  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }

    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }

  }
}


Après avoir chargé la page Web dans un navigateur, cliquez sur le contrôle de liste déroulante Mode d'affichage et sélectionnez Connecter pour faire basculer la page en mode connexion. Le mode connexion utilise l'élément <asp:connectionszone> pour vous permettre de créer des connexions entre les contrôles. En mode connexion, cliquez sur la flèche vers le bas dans la barre de titre du contrôle Code postal pour activer son menu d'actions verbales, puis cliquez sur Connecter. Lorsque l'interface utilisateur de connexion apparaît, cliquez sur le lien Créer une connexion à un consommateur. Une cellule apparaît avec un contrôle de liste déroulante. Sélectionnez Weather Control dans la liste déroulante, puis cliquez sur Connecter pour effectuer la connexion des deux contrôles. Cliquez sur Fermer, puis utilisez la liste déroulante Mode d'affichage pour rétablir la page en mode de navigation normal. Vous pouvez entrer un code postal, le contrôle consommateur sera mis à jour avec la valeur saisie. Compte tenu que la propriété ZipCode a été marquée avec l'attribut Personalizable dans le code source, cette valeur de propriété persistera d'une session de navigateur à l'autre, sauvegardant ainsi la valeur saisie par un utilisateur. Un contrôle consommateur plus sophistiqué pourrait prendre les informations de code postal, rechercher les informations météo basées sur le code et les afficher à l'attention d'un utilisateur.

.NET Framework

Pris en charge dans : 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 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft