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 classe

 

Date de publication : novembre 2016

Sert de classe centrale du jeu de composants webPart en gérant l’ensemble des contrôles, fonctionnalités et événements webPart qui se produisent sur une page web.

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

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

[BindableAttribute(false)]
public class WebPartManager : Control, INamingContainer, IPersonalizable

NomDescription
System_CAPS_pubmethodWebPartManager()

Initialise une nouvelle instance de la classe WebPartManager.

NomDescription
System_CAPS_protpropertyAdapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application de la Page ou UserControl objet qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAvailableTransformers

Obtient une collection de WebPartTransformer utilisent des objets qui sont disponibles pour créer des connexions WebPart entre les contrôles serveur.

System_CAPS_pubpropertyBindingContainer

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le contrôle qui contient la liaison de données de ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.(Hérité de Control.)

System_CAPS_pubpropertyClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.(Hérité de Control.)

System_CAPS_pubpropertyClientIDMode

Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.(Hérité de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans le ClientID propriété.(Hérité de Control.)

System_CAPS_pubpropertyCloseProviderWarning

Obtient ou définit un avertissement qui s’affiche lorsqu’un utilisateur ferme un contrôle qui agit comme un fournisseur pour d’autres contrôles dans une connexion.

System_CAPS_pubpropertyConnections

Obtient une référence à la collection de toutes les connexions actives sur une page Web.

System_CAPS_protpropertyContext

Obtient le HttpContext est associé au contrôle serveur pour la demande Web actuelle.(Hérité de Control.)

System_CAPS_pubpropertyControls

Obtient la collection de tous les WebPart, serveur ou des contrôles utilisateur qui sont contenues dans WebPartZoneBase de zones sur une page Web et sont gérés par la WebPartManager contrôle.(Remplace Control.Controls.)

System_CAPS_pubpropertyDataItemContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataItemContainer.(Hérité de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataKeysControl.(Hérité de Control.)

System_CAPS_pubpropertyDeleteWarning

Obtient ou définit un message d’avertissement personnalisé affiché aux utilisateurs finaux lorsqu’ils suppriment un contrôle.

System_CAPS_protpropertyDesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertyDisplayMode

Obtient ou définit le mode d’affichage actif pour une page Web qui contient des contrôles WebPart.

System_CAPS_pubpropertyDisplayModes

Obtient une collection en lecture seule de tous les modes d’affichage qui sont associés un WebPartManager contrôle.

System_CAPS_protpropertyDynamicConnections

Obtient la collection de toutes les connexions dynamiques qui existent actuellement sur une page Web.

System_CAPS_pubpropertyEnableClientScript

Obtient ou définit une valeur qui détermine si le script côté client est activé sur la page Web contenant un WebPartManager contrôle.

System_CAPS_pubpropertyEnableTheming

Obtient une valeur qui indique que l’utilisation de thèmes est activée sur une page Web.(Remplace Control.EnableTheming.)

System_CAPS_pubpropertyEnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.(Hérité de Control.)

System_CAPS_protpropertyEvents

Obtient une liste de délégués de gestionnaires d’événements pour le contrôle. Cette propriété est en lecture seule.(Hérité de Control.)

System_CAPS_pubpropertyExportSensitiveDataWarning

Obtient ou définit le texte d’un message d’avertissement qui s’affiche lorsqu’un utilisateur tente d’exporter des données d’état sensibles d’un WebPart contrôle.

System_CAPS_protpropertyHasChildViewState

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur actuel ont tous les paramètres d’état d’affichage enregistrés.(Hérité de Control.)

System_CAPS_pubpropertyID

Obtient ou définit l’identificateur programmatique assigné au contrôle serveur.(Hérité de Control.)

System_CAPS_protpropertyIdSeparator

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le caractère utilisé pour séparer les identificateurs de contrôle.(Hérité de Control.)

System_CAPS_protpropertyInternals

Obtient une référence à la WebPartManagerInternals classe, qui est utilisée pour combiner et séparer un jeu de méthodes qui sont réellement implémentées dans la WebPartManager de classe, mais sont surtout utiles aux développeurs de contrôles.

System_CAPS_protpropertyIsChildControlStateCleared

Obtient une valeur qui indique si les contrôles contenus dans ce contrôle ont état du contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsCustomPersonalizationStateDirty

Obtient une valeur qui indique si les modifications de personnalisation apportées affectent les détails de la personnalisation au niveau de la page contrôlés par le WebPartManager contrôle.

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.(Hérité de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.(Hérité de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index.(Hérité de Control.)

System_CAPS_protpropertyMediumPermissionSet

Obtient un PermissionSet objet autorise uniquement SecurityPermissionFlag.Execution autorisation et AspNetHostingPermissionLevel.Medium autorisation.

System_CAPS_protpropertyMinimalPermissionSet

Obtient un PermissionSet objet autorise uniquement SecurityPermissionFlag.Execution autorisation et AspNetHostingPermissionLevel.Minimal autorisation.

System_CAPS_pubpropertyNamingContainer

Obtient une référence au contrôle de serveur de noms de conteneur, ce qui crée un espace de noms unique pour différencier les contrôles serveur avec le même Control.ID valeur de propriété.(Hérité de Control.)

System_CAPS_pubpropertyPage

Obtient une référence à la Page instance qui contient le contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyParent

Obtient une référence au contrôle parent du contrôle de serveur dans la hiérarchie de contrôle de page.(Hérité de Control.)

System_CAPS_pubpropertyPersonalization

Obtient une référence à un objet qui contient les données de personnalisation pour une page Web.

System_CAPS_pubpropertyRenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET HTML restitué sera compatible avec.(Hérité de Control.)

System_CAPS_pubpropertySelectedWebPart

Obtient une référence à un WebPart ou un autre contrôle serveur actuellement sélectionné pour modifier ou créer une connexion avec un autre contrôle.

System_CAPS_pubpropertySite

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertySkinID

Obtient ou définit une chaîne vide (« ») afin qu’aucune apparence ne peut être appliquée à la WebPartManager contrôle.(Remplace Control.SkinID.)

System_CAPS_pubpropertyStaticConnections

Obtient une référence à la collection de tous les WebPartConnection sur une page Web, les objets qui sont définis comme des connexions statiques.

System_CAPS_pubpropertySupportedDisplayModes

Obtient une collection en lecture seule de tous les modes d’affichage disponibles sur une page Web spécifique.

System_CAPS_pubpropertyTemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtient le répertoire virtuel de le Page ou UserControl qui contient le contrôle serveur en cours.(Hérité de Control.)

System_CAPS_pubpropertyUniqueID

Obtient l’identificateur unique qualifié hiérarchiquement du contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie les entrées de client à partir du navigateur de valeurs potentiellement dangereuses.(Hérité de Control.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et restaurer l’état d’affichage d’un contrôle serveur entre plusieurs demandes de la même page.(Hérité de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtient une valeur qui indique si le StateBag objet respecte la casse.(Hérité de Control.)

System_CAPS_pubpropertyViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyVisible

Obtient une valeur qui permet aux contrôles enfants soient visibles.(Remplace Control.Visible.)

System_CAPS_pubpropertyWebParts

Obtient une référence à tous les WebPart contrôles suivies par le WebPartManager contrôle sur une page Web.

System_CAPS_pubpropertyZones

Obtient une référence à une collection de tous les WebPartZoneBase zones sur une page Web.

NomDescription
System_CAPS_protmethodActivateConnections()

Rend active toutes les connexions sur une page Web qui sont actuellement inactives.

System_CAPS_protmethodAddedControl(Control, Int32)

Appelée après qu’un contrôle enfant est ajouté à la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifie au contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodAddWebPart(WebPart, WebPartZoneBase, Int32)

Fournit la méthode par programme standard pour ajouter WebPart contrôles à une page Web.

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de page pour le contrôle.(Hérité de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design de données de rendu.(Hérité de Control.)

System_CAPS_pubmethodBeginWebPartConnecting(WebPart)

Démarre le processus de connexion de deux WebPart contrôles.

System_CAPS_pubmethodBeginWebPartEditing(WebPart)

Démarre le processus de modification d’un WebPart contrôle.

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Rassemble des informations sur le contrôle serveur, puis les remet à la Trace propriété à afficher lorsque le traçage est activé pour la page.(Hérité de Control.)

System_CAPS_pubmethodCanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Vérifie la WebPart contrôles 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 WebPartTransformer objet n’est pas nécessaire.

System_CAPS_pubmethodCanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Vérifie la WebPart contrôles qui participeront à une connexion pour déterminer s’ils peuvent être connectés et utilisent un WebPartTransformer objet pour créer la connexion entre un fournisseur et un consommateur incompatible.

System_CAPS_protmethodCheckRenderClientScript()

Vérifie les fonctionnalités du navigateur qui effectue la demande et la valeur de la EnableClientScript propriété, afin de déterminer s’il faut restituer le script client.

System_CAPS_protmethodClearCachedClientID()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la mise en cache ClientID valeur null.(Hérité de Control.)

System_CAPS_protmethodClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodClearChildState()

Supprime les informations d’état d’affichage et état du contrôle pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearChildViewState()

Supprime les informations d’état d’affichage pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le ClientIDMode propriété de l’instance actuelle du contrôle et de ses contrôles enfants à Inherit.(Hérité de Control.)

System_CAPS_pubmethodCloseWebPart(WebPart)

Ferme un WebPart contrôle de sorte qu’il n’est pas rendu sur une page Web, mais peut être rouverte.

System_CAPS_pubmethodConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Crée une connexion entre deux WebPart ou GenericWebPart contrôle à l’aide uniquement les références aux contrôles et leurs spécifié ConnectionPoint objets.

System_CAPS_pubmethodConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Crée une connexion entre deux WebPart ou GenericWebPart contrôle en utilisant les références aux contrôles, leurs spécifiés ConnectionPoint objets et un WebPartTransformer objet.

System_CAPS_protmethodCopyWebPart(WebPart)

Utilisé par le contrôle WebPart défini pour créer une copie d’un WebPart ou un contrôle serveur en vue d’ajouter le contrôle à une page Web.

System_CAPS_protmethodCreateAvailableTransformers()

Crée un jeu de transformateurs spécifié dans le fichier de configuration d’un site Web et les ajoute à la collection de transformateurs référencée par la AvailableTransformers propriété.

System_CAPS_protmethodCreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.(Hérité de Control.)

System_CAPS_protmethodCreateControlCollection()

Retourne la collection de tous les contrôles qui sont gérés par la WebPartManager contrôle sur une page Web. Cette classe ne peut pas être héritée.(Remplace Control.CreateControlCollection().)

System_CAPS_protmethodCreateDisplayModes()

Crée le jeu de tous les modes d’affichage possibles pour une application WebPart.

System_CAPS_protmethodCreateDynamicConnectionID()

Obtient une valeur unique pour servir d’ID pour une connexion dynamique.

System_CAPS_protmethodCreateDynamicWebPartID(Type)

Génère un ID unique pour un dynamique WebPart contrôle.

System_CAPS_protmethodCreateErrorWebPart(String, String, String, String, String)

Crée un contrôle spécial qui est inséré dans une page et affiché pour les utilisateurs finaux lorsqu’une tentative de chargement ou de créer un dynamique WebPart contrôle échoue pour une raison quelconque.

System_CAPS_protmethodCreatePersonalization()

Retourne un objet de personnalisation pour contenir les données de personnalisation d’un utilisateur de la page Web actuelle.

System_CAPS_pubmethodCreateWebPart(Control)

Encapsule un contrôle serveur qui n’est pas un WebPart contrôler avec un GenericWebPart de l’objet, afin que le contrôle peut avoir des fonctionnalités WebPart.

System_CAPS_pubmethodDataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodDataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher la DataBinding événement.(Hérité de Control.)

System_CAPS_protmethodDataBindChildren()

Lie une source de données à des contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodDeleteWebPart(WebPart)

Supprime définitivement une instance dynamique d’un WebPart contrôle à partir d’une page Web.

System_CAPS_protmethodDisconnectWebPart(WebPart)

Supprime un WebPart ou contrôle serveur qui est est fermé ou supprimé de toutes les connexions, il participe.

System_CAPS_pubmethodDisconnectWebParts(WebPartConnection)

Exécute le processus de déconnexion des contrôles serveur qui sont connectés sur une page Web.

System_CAPS_pubmethodDispose()

Permet à un contrôle serveur effectuer de nettoyage final avant qu’il est libéré de la mémoire.(Hérité de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Se termine au moment du design le suivi des données de rendu.(Hérité de Control.)

System_CAPS_pubmethodEndWebPartConnecting()

Termine le processus de connexion d’un WebPart contrôle à un autre contrôle.

System_CAPS_pubmethodEndWebPartEditing()

Termine le processus de modification d’un WebPart contrôle.

System_CAPS_protmethodEnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si elle n’est pas le cas, il crée contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodEnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.(Hérité de Control.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodExportWebPart(WebPart, XmlWriter)

Crée un fichier de description XML qui contient les données d’état et de propriété d’un contrôle serveur.

System_CAPS_protmethodFinalize()

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.)

System_CAPS_pubmethodFindControl(String)

Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id paramètre.(Hérité de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id et un entier, spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas substituer cette version de la FindControl méthode.(Hérité de Control.)

System_CAPS_pubmethodFocus()

Substitué pour empêcher le focus d’être défini sur le WebPartManager contrôler, car aucune interface utilisateur (IU).(Remplace Control.Focus().)

System_CAPS_pubmethodGetConsumerConnectionPoints(WebPart)

Récupère la collection de ConsumerConnectionPoint objets qui peuvent agir en tant que points de connexion d’un serveur de contrôlent agissant comme consommateur dans une connexion WebPart.

System_CAPS_pubmethodSystem_CAPS_staticGetCurrentWebPartManager(Page)

Récupère une référence à l’instance actuelle de la WebPartManager contrôle sur une page.

System_CAPS_protmethodGetDesignModeState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_protmethodGetDisplayTitle(WebPart)

Obtient une chaîne contenant la valeur de la DisplayTitle propriété d’un WebPart contrôle.

System_CAPS_pubmethodGetExportUrl(WebPart)

Obtient 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 WebPart contrôle.

System_CAPS_pubmethodGetGenericWebPart(Control)

Obtient une référence à l’instance de la GenericWebPart contrôle qui contient un contrôle serveur.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetProviderConnectionPoints(WebPart)

Récupère la collection de ProviderConnectionPoint objets qui peuvent agir en tant que points de connexion d’un serveur de contrôlent agissant comme un fournisseur dans une connexion WebPart.

System_CAPS_pubmethodGetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodHasControls()

Détermine si le contrôle serveur contient des contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodHasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou tous les contrôles enfants.(Hérité de Control.)

System_CAPS_pubmethodImportWebPart(XmlReader, String)

Importe un fichier de description XML qui contient les données d’état et de propriété pour un WebPart contrôler et applique les données au contrôle.

System_CAPS_pubmethodIsAuthorized(Type, String, String, Boolean)

Exécute les étapes finales de déterminer si un contrôle est autorisé à être ajouté à une page.

System_CAPS_pubmethodIsAuthorized(WebPart)

Exécute les étapes initiales permettant de déterminer si un contrôle est autorisé à être ajouté à une page.

System_CAPS_protmethodIsLiteralContent()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si le contrôle serveur détient uniquement un contenu littéral.(Hérité de Control.)

System_CAPS_protmethodLoadControlState(Object)

Charges de contrôlent les données d’état qui a été enregistrées à partir d’une demande de page précédente et doivent être restaurée sur une demande ultérieure.(Remplace Control.LoadControlState(Object).)

System_CAPS_protmethodLoadCustomPersonalizationState(PersonalizationDictionary)

Stocke les données de personnalisation qui ont été transmises au contrôle WebPartManager par les objets de personnalisation, en vue d’une utilisation ultérieure pendant le processus d’initialisation.

System_CAPS_protmethodLoadViewState(Object)

Restaure les informations d’état d’affichage d’une demande de page précédente enregistrée par la SaveViewState méthode.(Hérité de Control.)

System_CAPS_protmethodMapPathSecure(String)

Récupère le chemin d’accès physique correspondant à un chemin d’accès virtuel, absolu ou relatif.(Hérité de Control.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodMoveWebPart(WebPart, WebPartZoneBase, Int32)

Déplace un WebPart ou un contrôle serveur à partir d’un WebPartZoneBase fuseau vers un autre, ou vers une nouvelle position dans le même fuseau horaire.

System_CAPS_protmethodOnAuthorizeWebPart(WebPartAuthorizationEventArgs)

Déclenche la AuthorizeWebPart événements et appelle un gestionnaire pour l’événement, le cas échéant.

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.(Hérité de Control.)

System_CAPS_protmethodOnConnectionsActivated(EventArgs)

Déclenche la ConnectionsActivated événement pour indiquer qu’une page et ses contrôles sont chargés, et les connexions sur la page ont été activées pour commencer le partage des données.

System_CAPS_protmethodOnConnectionsActivating(EventArgs)

Déclenche la ConnectionsActivating événement pour indiquer qu’une page et ses contrôles ont été chargés et que le processus d’activation des connexions peut commencer.

System_CAPS_protmethodOnDataBinding(EventArgs)

Déclenche l'événement DataBinding.(Hérité de Control.)

System_CAPS_protmethodOnDisplayModeChanged(WebPartDisplayModeEventArgs)

Déclenche la DisplayModeChanged événement pour indiquer que le WebPartManager contrôle a terminé le processus de basculement d’un mode d’affichage à un autre sur une page Web.

System_CAPS_protmethodOnDisplayModeChanging(WebPartDisplayModeCancelEventArgs)

Déclenche la DisplayModeChanging événement pour indiquer que le WebPartManager contrôle est en train de basculer d’un mode d’affichage à un autre sur une page Web.

System_CAPS_protmethodOnInit(EventArgs)

Déclenche la Init événement, qui est le premier événement dans la WebPartManager cycle de vie de contrôle.(Remplace Control.OnInit(EventArgs).)

System_CAPS_protmethodOnLoad(EventArgs)

Déclenche l'événement Load.(Hérité de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Déclenche la PreRender événement qui se produit juste avant une WebPartManager contrôle est restitué sur une page Web.(Remplace Control.OnPreRender(EventArgs).)

System_CAPS_protmethodOnSelectedWebPartChanged(WebPartEventArgs)

Déclenche la SelectedWebPartChanged événement qui se produit après un WebPart contrôle a été récemment sélectionné ou était sa sélection vide.

System_CAPS_protmethodOnSelectedWebPartChanging(WebPartCancelEventArgs)

Déclenche la SelectedWebPartChanging événement qui se produit pendant le processus de changement WebPart contrôle actuellement sélectionné.

System_CAPS_protmethodOnUnload(EventArgs)

Déclenche la base Unload événement et supprime la WebPartManager instance à partir d’une page Web.(Remplace Control.OnUnload(EventArgs).)

System_CAPS_protmethodOnWebPartAdded(WebPartEventArgs)

Déclenche la WebPartAdded événement qui se produit après un WebPart contrôle a été ajouté à une page.

System_CAPS_protmethodOnWebPartAdding(WebPartAddingEventArgs)

Déclenche la WebPartAdding événement qui se produit pendant le processus d’ajout d’un WebPart contrôle (ou un contrôle serveur ou utilisateur) à un WebPartZoneBase zone.

System_CAPS_protmethodOnWebPartClosed(WebPartEventArgs)

Déclenche la WebPartClosed événement pour signaler qu’un contrôle a été supprimé d’une page.

System_CAPS_protmethodOnWebPartClosing(WebPartCancelEventArgs)

Déclenche la WebPartClosing événement qui se produit pendant le processus d’un WebPart ou un contrôle serveur supprimé d’une page.

System_CAPS_protmethodOnWebPartDeleted(WebPartEventArgs)

Déclenche la WebPartDeleted événement qui se produit après un WebPart contrôle a été supprimé définitivement d’une page.

System_CAPS_protmethodOnWebPartDeleting(WebPartCancelEventArgs)

Déclenche la WebPartDeleting événement, ce qui indique qu’une dynamique WebPart contrôle (ou contrôle serveur ou utilisateur contenu dans un WebPartZoneBase zone) est en cours de suppression.

System_CAPS_protmethodOnWebPartMoved(WebPartEventArgs)

Déclenche la WebPartMoved événement qui se produit après un WebPart contrôle a été déplacé vers un emplacement différent sur une page.

System_CAPS_protmethodOnWebPartMoving(WebPartMovingEventArgs)

Déclenche la WebPartMoving événement, ce qui indique qu’un WebPart ou d’un contrôle serveur ou utilisateur dans un WebPartZoneBase zone est en cours de déplacement.

System_CAPS_protmethodOnWebPartsConnected(WebPartConnectionsEventArgs)

Déclenche la WebPartsConnected événement qui se produit après qu’une connexion a été établie entre WebPart contrôles.

System_CAPS_protmethodOnWebPartsConnecting(WebPartConnectionsCancelEventArgs)

Déclenche la WebPartsConnecting événement qui se produit pendant le processus d’établissement d’une connexion entre deux WebPart ou contrôles serveur ou utilisateur contenus dans un WebPartZoneBase zone.

System_CAPS_protmethodOnWebPartsDisconnected(WebPartConnectionsEventArgs)

Déclenche la WebPartsDisconnected événement qui se produit une fois la connexion entre WebPart contrôles s’est terminée.

System_CAPS_protmethodOnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)

Déclenche la WebPartsDisconnecting l’événement, qui indique que deux WebPart ou contrôles serveur ou utilisateur dans une WebPartZoneBase zone sont en cours de clôture de connexion.

System_CAPS_protmethodOpenFile(String)

Obtient un Stream utilisé pour lire un fichier.(Hérité de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assigne toute source de l’événement et ses informations au parent du contrôle.(Hérité de Control.)

System_CAPS_protmethodRegisterClientScript()

Permet la WebPartManager contrôle d’émettre un script côté client utilisé pour diverses fonctionnalités de personnalisation, telles que le glissement WebPart contrôles dans une page Web.

System_CAPS_protmethodRemovedControl(Control)

Appelée après qu’un contrôle enfant est supprimé de la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Substitué pour empêcher le WebPartManager contrôle de rendre du contenu.(Remplace Control.Render(HtmlTextWriter).)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Renvoie le contenu des enfants d’un contrôle serveur à une collection HtmlTextWriter objet, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter de l’objet et stocke les informations de traçage sur le contrôle si le traçage est activé.(Hérité de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter à l’aide d’un ControlAdapter objet.(Hérité de Control.)

System_CAPS_protmethodResolveAdapter()

Obtient l’adaptateur de contrôles responsable du rendu du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.(Hérité de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convertit une URL qui est utilisable sur le client demandeur.(Hérité de Control.)

System_CAPS_protmethodSaveControlState()

Enregistre les données d’état du WebPartManager contrôle afin que les données peuvent être restaurées sur demande ultérieure à la page Web qui contient le contrôle.(Remplace Control.SaveControlState().)

System_CAPS_protmethodSaveCustomPersonalizationState(PersonalizationDictionary)

Enregistre les données d’état de personnalisation gérées par le WebPartManager contrôle, de sorte que ces données puissent être rechargées à chaque fois que la page est rechargée.

System_CAPS_protmethodSaveViewState()

Enregistre les changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur.(Hérité de Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_protmethodSetPersonalizationDirty()

Définit un indicateur qui signale que des données de personnalisation personnalisées pour le WebPartManager contrôle a changé.

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Assigne un délégué de gestionnaire d’événements pour afficher le contrôle de serveur et son contenu dans son contrôle parent.(Hérité de Control.)

System_CAPS_protmethodSetSelectedWebPart(WebPart)

Définit le SelectedWebPart valeur égale à actuellement sélectionné de la propriété WebPart ou un contrôle serveur.

System_CAPS_pubmethodSetTraceData(Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de l’objet de suivi, la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Applique les données d’état de personnalisation à le WebPartManager contrôle et appelle la méthode de base pour activer le suivi des modifications aux données d’état d’affichage pour le contrôle.(Remplace Control.TrackViewState().)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticBrowseDisplayMode

Représente le mode d’affichage par défaut pour les pages qui contiennent des contrôles WebPart. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticCatalogDisplayMode

Représente le mode d’affichage permettant d’ajouter des contrôles serveur à partir d’un catalogue de contrôles à une page Web. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticConnectDisplayMode

Représente le mode d’affichage permettant d’afficher une interface utilisateur (IU) permettant aux utilisateurs de gérer les connexions entre WebPart contrôles. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticDesignDisplayMode

Repré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.

System_CAPS_pubfieldSystem_CAPS_staticEditDisplayMode

Représente le mode d’affichage dans lequel les utilisateurs finaux peuvent modifier et modifier des contrôles serveur. Ce champ est en lecture seule.

NomDescription
System_CAPS_pubeventAuthorizeWebPart

Se produit lorsque la IsAuthorized méthode est appelée pour déterminer si un WebPart ou contrôle serveur peut être ajouté à une page.

System_CAPS_pubeventConnectionsActivated

Se produit après que toutes les connexions de composants WebPart en cours sur 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.

System_CAPS_pubeventConnectionsActivating

Se produit pendant le processus d’activation de toutes les connexions WebPart établies sur une page Web.

System_CAPS_pubeventDataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.(Hérité de Control.)

System_CAPS_pubeventDisplayModeChanged

Se produit après le mode d’affichage actuel sur un composant WebPart page a changé.

System_CAPS_pubeventDisplayModeChanging

Se produit lorsqu’un utilisateur clique sur un verbe dans une page Web qui commence le processus de modification pour un mode d’affichage différent.

System_CAPS_pubeventDisposed

Se produit lorsqu’un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie serveur contrôle lorsqu’une page ASP.NET est demandée.(Hérité de Control.)

System_CAPS_pubeventInit

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape du cycle de vie.(Hérité de Control.)

System_CAPS_pubeventLoad

Se produit lorsque le contrôle serveur est chargé dans le Page objet.(Hérité de Control.)

System_CAPS_pubeventPreRender

Se produit après le Control objet est chargé, mais avant le rendu.(Hérité de Control.)

System_CAPS_pubeventSelectedWebPartChanged

Se produit après la sélection d’un WebPart contrôle a été modifiée et déplacée vers un autre contrôle sur une page Web.

System_CAPS_pubeventSelectedWebPartChanging

Se produit pendant le processus de changement WebPart ou contrôle serveur actuellement sélectionné sur une page Web.

System_CAPS_pubeventUnload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.(Hérité de Control.)

System_CAPS_pubeventWebPartAdded

Se produit après un dynamique WebPart ou tout autre contrôle serveur a été ajouté à un WebPartZoneBase zone, pour indiquer que le contrôle a été ajouté avec succès.

System_CAPS_pubeventWebPartAdding

Se produit pendant le processus d’ajout d’une dynamique WebPart ou tout autre contrôle serveur à un WebPartZoneBase zone.

System_CAPS_pubeventWebPartClosed

Se produit lorsqu’un WebPart contrôle (ou contrôle serveur ou utilisateur) est supprimé d’une page.

System_CAPS_pubeventWebPartClosing

Se produit pendant le processus de suppression d’un WebPart contrôle (ou contrôle serveur ou utilisateur) à partir d’une page.

System_CAPS_pubeventWebPartDeleted

Se produit après qu’un WebPart ou tout autre contrôle serveur a été supprimé une WebPartZoneBase zone.

System_CAPS_pubeventWebPartDeleting

Se produit pendant le processus de suppression définitive d’une instance d’un dynamique WebPart ou autre contrôle serveur dans un WebPartZoneBase zone.

System_CAPS_pubeventWebPartMoved

Se produit après qu’un WebPart ou contrôle serveur a été déplacé vers un emplacement différent sur une page Web.

System_CAPS_pubeventWebPartMoving

Se produit pendant le processus de déplacement d’un WebPart ou un autre contrôle serveur qui est contenue dans un WebPartZoneBase zone.

System_CAPS_pubeventWebPartsConnected

Se produit après qu’une connexion spécifique a été établie entre WebPart contrôles (ou contrôles serveur ou utilisateur).

System_CAPS_pubeventWebPartsConnecting

Se produit pendant le processus de création d’une connexion entre WebPart contrôles (ou contrôles serveur ou utilisateur placés dans une WebPartZoneBase zone).

System_CAPS_pubeventWebPartsDisconnected

Se produit après qu’une connexion entre deux WebPart ou contrôles serveur a été arrêté.

System_CAPS_pubeventWebPartsDisconnecting

Se produit pendant le processus de clôture de connexion entre précédemment connecté WebPart ou contrôles serveur.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPersonalizable.Load(PersonalizationDictionary)

Retourne les données d’état de personnalisation précédemment enregistrées à charger dans le contrôle WebPartManager.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPersonalizable.Save(PersonalizationDictionary)

Enregistre les données d’état de personnalisation sont gérées par le WebPartManager contrôle.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIPersonalizable.IsDirty

Obtient une valeur qui indique si les données d’état de personnalisation personnalisées gérées par le WebPartManager contrôle a été modifié sur une page Web.

NomDescription
System_CAPS_pubmethodEnableDynamicData(Type)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, IDictionary<String, Object>)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, Object)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodFindDataSourceControl()

Retourne la source de données qui est associée au contrôle de données pour le contrôle spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retourne que le modèle de champ pour la colonne spécifiée dans le contrôle spécifié du conteneur de dénomination.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retourne l’objet metatable pour le contrôle de données conteneur.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Surchargé. Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Surchargé. Obtient les métadonnées de table pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable)

Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, IDictionary<String, Object>)

Surchargé. Définit le mappage table de valeurs par défaut et les métadonnées pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, Object)

Surchargé. Définit le mappage table de valeurs par défaut et les métadonnées pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Surchargé. Détermine si les métadonnées de la table sont disponible.(Défini par DynamicDataExtensions.)

Le WebPartManager contrôle agit comme le centre de concentrateur ou de contrôle d’une application de composants WebPart. Il doit y avoir un seul--et unique--WebPartManager instance de contrôle sur chaque page qui utilise des contrôles WebPart. Comme avec la plupart des aspects des applications WebPart, les WebPartManager contrôle fonctionne uniquement avec les 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 WebZone classe. Contrôles serveur qui résident sur une page en dehors de ces zones peuvent avoir très peu de fonctionnalités WebPart ou d’interaction avec le WebPartManager contrôle.

Comme concentrateur pour fonctionnalités WebPart sur une page, le WebPartManager contrôle exécute les types de tâches décrites dans le tableau suivant.

Catégorie de tâche

Ce que fait le contrôle

Suivi des contrôles WebPart

Effectue le suivi de nombreux types de contrôles sur une page qui fournissent des fonctionnalités de composants WebPart, y compris WebPart contrôles, les connexions, les zones et autres.

Ajout et suppression de contrôles WebPart

Fournit les méthodes pour l’ajout, la suppression et la fermeture de WebPart contrôles 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 les supprimer.

Personnalisation des pages et des contrôles

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, propriétés et le comportement de contrôles. Conserve les paramètres de personnalisation spécifiques à l’utilisateur sur chaque page.

Basculement entre les différentes vues de page

Bascule une page entre les différentes vues spécialisées de la page, afin que les utilisateurs puissent exécuter certaines tâches telles que la modification de mise en page ou les contrôles d’édition.

Le déclenchement d’événements de cycle de vie des composants WebPart

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

L’activation d’importation et exportation de contrôles

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

La WebPartManager classe a un grand ensemble de propriétés. Cohérent avec la WebPartManager rôle de suivi d’autres contrôles, il a un nombre de propriétés qui référencent des collections de contrôles WebPart, ou d’autres objets WebPart spéciaux. Le AvailableTransformers, Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebParts, et Zones propriétés sont toutes les collections sont utilisées par le WebPartManager contrôle 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. Celles-ci incluent la CloseProviderWarning, le DeleteWarninget le ExportSensitiveDataWarning propriétés.

La WebPartManager classe substitue certaines propriétés de base héritées, qui sont utilisées par nombreux contrôles serveur Web. Celles-ci incluent la EnableTheming, SkinID, et Visible propriétés.

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

Le WebPartManager contrôle contient cinq modes d’affichage intégrés ou des vues d’une page Web. Les développeurs peuvent étendre cette fonctionnalité, en créant des modes d’affichage personnalisé en étendant des types tels que les WebZone classe ou la ToolZone classe. Les utilisateurs peuvent basculer d’une page dans les différents modes d’affichage, sous réserve que le type approprié de contrôles qui correspondent à un mode d’affichage donné sont présentes dans une page.

System_CAPS_noteRemarque

Il est possible d’étendre cette fonctionnalité afin que les utilisateurs peuvent basculer en 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 WebPartManager classe. Le tableau suivant récapitule les champs et les modes d’affichage qu'ils font référence. Le mode d’affichage actuel d’une page, comme indiqué ci-dessus, est toujours référencé dans le DisplayMode propriété et que le jeu de modes d’affichage possibles sur une page particulière, compte tenue du type de zones qui sont présents dans la page, est contenue dans le SupportedDisplayModes propriété.

Champ

En mode affichage des détails

BrowseDisplayMode

Le mode utilisateur normal d’une page Web ; mode d’affichage par défaut et la plus courante.

DesignDisplayMode

La vue dans laquelle les utilisateurs peuvent réorganiser ou supprimer des contrôles pour modifier la mise en page.

EditDisplayMode

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

CatalogDisplayMode

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

ConnectDisplayMode

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

Le WebPartManager contrôle contient également un nombre d’événements critiques dans le cycle de vie des pages de composants WebPart et des contrôles. 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 WebPart contrôles (ou d’autres contrôles serveur ou utilisateur qui sont placés dans WebPartZoneBase afin qu’ils peuvent se comporter comme des zones WebPart contrôles). Toutefois, quelques événements se rapportent à l’état de la page ou les connexions sur la page. Le tableau suivant répertorie les événements disponibles et résume leurs fonctions.

System_CAPS_noteRemarque

Dans tous les cas dans le tableau suivant, le mot « contrôle » fait référence à un WebPart contrôle ou n’importe quel serveur qui réside dans une zone et qui est encapsulé avec un GenericWebPart objet en cours d’exécution.

event

Description

AuthorizeWebPart

Se produit juste avant l’ajout d’un contrôle à une page pour vérifier qu’il est autorisé.

ConnectionsActivated

Se produit une fois 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 changement de 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 l’ajout d’un contrôle à 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 (qui a été créé par programme ou à partir d’un catalogue) a été définitivement supprimée.

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 la déconnexion de deux contrôles connectés.

WebPartsDisconnecting

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

Le WebPartManager contrôle dispose de nombreuses méthodes pour gérer les pages de composants WebPart. Un grand ensemble de méthodes, non répertoriées ici, les méthodes dont les noms prennent la forme onEventName. Ces méthodes généralement déclencher son événement associé et fournissent à l’événement avec un gestionnaire de type WebPartEventHandler. La plupart de ces méthodes peut être substituée par les développeurs qui héritent de la WebPartManager classe. En outre, 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 la WebPartAdded événement, un développeur de pages peut ajouter un OnWebPartAdded attribut le <asp:webpartmanager> élément dans le balisage d’une page Web, puis assignez le nom de méthode personnalisée à l’attribut pour fournir une gestion personnalisée pour l’événement. L’attribut correspond à la OnWebPartAdded (méthode) et ce modèle de base de fonctionnement pour la plupart des événements WebPart et leurs méthodes associées de la gestion des événements.

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

Un autre ensemble de méthodes est spécialisé pour les connexions. This includes methods such as ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnecting, GetConsumerConnectionPoints, and GetProviderConnectionPoints.

Enfin, certaines WebPartManager méthodes vous concentrer sur les fonctionnalités de personnalisation. These include CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save, and SaveControlState.

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

Remarques à l’attention des héritiers :

Le WebPartManager contrôle est conçu pour être étendu. Étant donné qu’il est central pour les applications WebPart, lorsque vous souhaitez étendre un type spécifique ou de contrôle dans le jeu de composants WebPart, dans de nombreux cas, vous devez également étendre le WebPartManager classe, car il est susceptible d’avoir une propriété ou une méthode qui est nécessaire pour que votre type personnalisé fonctionne dans le contexte d’une application WebPart. Documentation de référence WebPart (voir System.Web.UI.WebControls.WebParts), lorsque vous expliquant comment étendre un WebPart type mentionne ce qui doit être fait pour étendre la WebPartManager classe également ou montre comment l’étendre dans un exemple de code.

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

L’exemple de code de quatre parties :

  • Un contrôle utilisateur qui permet de modifier les modes d’affichage sur une page WebPart.

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

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

  • Une explication du fonctionne 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 tenue des contrôles WebPart qui sont présents dans la page. Dans la page Web pour cet exemple de code, ce contrôle utilisateur est déclaré juste en dessous de la WebPartManager élément dans le balisage de la page et qu’il existe un Register directive au début de la page Web pour inscrire 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>

Le balisage déclaratif de la page Web contient Register directives pour le contrôle utilisateur et les contrôles personnalisés. Il existe un <asp:webpartmanager> élément, un <asp:webpartzone> élément doit contenir les contrôles personnalisés et un <asp:connectionszone> élément. La page contient également du code incorporé qui gère les événements liés à la connexion pour le WebPartManager contrôler ; vous pouvez voir l’effet de ce code comme vous connectez et de Déconnectez 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 est le code source pour les contrôles. Notez qu’il existe une interface nommée IZipCode, et cette interface est implémentée dans le ZipCodeWebPart classe. Cette classe a une méthode de rappel spéciale 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, ce qui permet au contrôle d’agir comme un consommateur de l’autre contrôle.

Pour l’exemple de code à exécuter, vous devez compiler ce code source. Vous pouvez compiler explicitement et placer l’assembly résultant dans le dossier Bin de votre site Web ou 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 code source dans un assembly et le Register le nom de l’assembly fait référence à la directive de la page Web. Pour une procédure pas à pas qui montre comment compiler, consultez Walkthrough: Developing and Using a Custom Web 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);
    }

  }
}

Une fois que vous avez chargé la page Web dans un navigateur, cliquez sur le Mode d’affichage contrôle de liste déroulante, puis sélectionnez connexion pour basculer la page en mode connexion. Le mode connexion utilise le <asp:connectionszone> élément 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 de la Code postal pour activer son menu de verbes de contrôle, puis cliquez sur connexion. Une fois l’interface utilisateur de connexion s’affiche, cliquez sur le créer une connexion à un consommateur lien. Une cellule apparaît avec un contrôle de liste déroulante. Sélectionnez contrôle météo dans la liste déroulante, puis cliquez sur connexion pour établir la connexion des deux contrôles. Cliquez sur fermer, puis utilisez le Mode d’affichage liste déroulante, pour retourner la page en mode de navigation normal. Vous pouvez entrer un Code postal et le contrôle consommateur sera mise à jour avec la valeur d’entrée. Étant donné que la ZipCode a été marquée avec le Personalizable dans le code source, cette valeur de propriété sera conservé dans les sessions de navigateur, ce qui évite la valeur entrée par un utilisateur. Un contrôle consommateur plus sophistiqué pourrait prendre les informations de code postal, rechercher des informations concernant la météo en fonction du code et présenter à un utilisateur.

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: