WebPartManagerInternals Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Isole dans une classe distincte les méthodes utilisées par le contrôle WebPartManager et susceptibles d'être remplacées par le développeur qui étend le contrôle, mais qui sont rarement nécessaires au développeur de pages.
public ref class WebPartManagerInternals sealedpublic sealed class WebPartManagerInternalstype WebPartManagerInternals = classPublic NotInheritable Class WebPartManagerInternals- Héritage
-
WebPartManagerInternals
Remarques
La WebPartManager classe est la plus grande classe du jeu de contrôles De composants WebPart. Il fait également partie des classes de composants WebPart les plus importantes, car il est utilisé sur chaque page Web contenant des contrôles WebPart, et il coordonne et gère tous les contrôles de composants WebPart d’une page.
Étant donné que la WebPartManager classe est utilisée si fréquemment et qu’elle contient de nombreuses méthodes exposées, certaines méthodes principalement nécessaires par les développeurs de contrôle qui étendent le WebPartManager contrôle sont contenues dans la WebPartManagerInternals classe . Cette isolation des méthodes moins utilisées dans la WebPartManagerInternals classe simplifie l’API de la WebPartManager classe, et les méthodes isolées n’apparaissent pas sur l’objet WebPartManager dans IntelliSense.
Les développeurs qui utilisent la WebPartManagerInternals classe sont susceptibles d’avoir des scénarios où ils doivent hériter du contrôle et le WebPartManager personnaliser largement. Par exemple, si vous créez une application portail web ou un ensemble empaqueté de contrôles WebPart avec des modes d’affichage personnalisés, des zones personnalisées, des verbes personnalisés, des contrôles personnalisés WebPart et d’autres extensions de l’interface utilisateur des composants WebPart de base, dans de nombreux cas (pas tous), vous devez remplacer et étendre certains des WebPartManager membres. Bien que la WebPartManagerInternals classe soit scellée et que vous ne puissiez pas en hériter, votre classe personnalisée WebPartManager devra probablement appeler un certain nombre de méthodes afin de WebPartManagerInternals gérer les contrôles de composants WebPart sur une page.
Notes
Comme la WebPartManager classe, la WebPartManagerInternals classe fournit un contrôle serveur qui n’a pas d’interface utilisateur et qui n’est jamais visible sur une page. Contrairement à WebPartManager, la WebPartManagerInternals classe n’est jamais déclarée dans le balisage d’une page ; il s’agit strictement d’un objet worker qui effectue des tâches en arrière-plan. La méthode classique de son utilisation est illustrée par la classe, qui le WebPartManager référence au moyen de la propriété protégée Internals , et utilise l’objet référencé pour appeler les WebPartManagerInternals méthodes.
La WebPartManagerInternals classe contient uniquement des méthodes ; il n’y a pas de propriétés ou d’événements. Toutes les méthodes de la classe impliquent la gestion des WebPart contrôles ou des connexions entre les contrôles.
Pour gérer les WebPart contrôles, WebPartManagerInternals inclut des méthodes permettant de les ajouter (AddWebPart), de les supprimer, de gérer les RemoveWebPartévénements CallOnDeleting), d’obtenir ou de définir des détails sur leur relation avec leur zone (par exemple, GetZoneID et SetZoneIndex) ou de définir des propriétés de contrôle de base WebPart (par exemple, SetIsClosed et SetHasSharedData).
Pour gérer les connexions, WebPartManagerInternals inclut des méthodes pour les supprimer (DeleteConnection), définir l’objet de transformateur à utiliser (SetTransformer), déterminer si une connexion est partagée et si elle est statique (SetIsShared(WebPartConnection, Boolean) et SetIsStatic(WebPartConnection, Boolean)) et définir un message d’erreur de connexion à utiliser (SetConnectErrorMessage).
Méthodes
| AddWebPart(WebPart) |
Ajoute un contrôle WebPart ou un contrôle serveur à la collection de contrôles WebPartManager du contrôle WebPart présent sur une page Web. |
| CallOnClosing(WebPart) |
Appelle la méthode OnClosing(EventArgs) du contrôle spécifié. |
| CallOnConnectModeChanged(WebPart) |
Appelle la méthode OnConnectModeChanged(EventArgs) du contrôle spécifié. |
| CallOnDeleting(WebPart) |
Appelle la méthode OnDeleting(EventArgs) du contrôle spécifié. |
| CallOnEditModeChanged(WebPart) |
Appelle la méthode OnEditModeChanged(EventArgs) du contrôle spécifié. |
| ConnectionDeleted(WebPartConnection) |
Indique si l'objet WebPartConnection spécifié a été supprimé. |
| CreateObjectFromType(Type) |
Crée un objet en fonction du paramètre transmis à la méthode. |
| DeleteConnection(WebPartConnection) |
Définit une propriété pour indiquer que l'objet de connexion spécifié a été supprimé. |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| GetZoneID(WebPart) |
Obtient l'ID d'une zone qui contient le contrôle WebPart spécifié ou le contrôle serveur. |
| LoadConfigurationState(WebPartTransformer, Object) |
Charge des données d'état précédemment enregistrées pour un objet WebPartTransformer qui participe à une connexion entre des contrôles. |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| RemoveWebPart(WebPart) |
Supprime un WebPart ou un autre contrôle serveur dans la collection de contrôles du contrôle WebPartManager. |
| SaveConfigurationState(WebPartTransformer) |
Enregistre des données d'état pour un objet WebPartTransformer qui participe à une connexion entre des contrôles. |
| SetConnectErrorMessage(WebPart, String) |
Établit un message d'erreur et oblige l'objet WebPartChrome, chargé de procéder au rendu d'un contrôle WebPart, à procéder à la restitution de ce message plutôt qu'à celle du contenu du contrôle. |
| SetHasSharedData(WebPart, Boolean) |
Définit une propriété avec pour valeur WebPart ou un autre contrôle serveur qui indique si le contrôle dispose de données de personnalisation partagées. |
| SetHasUserData(WebPart, Boolean) |
Définit une propriété avec pour valeur WebPart ou un autre contrôle serveur qui indique si le contrôle dispose de données de personnalisation utilisateur. |
| SetIsClosed(WebPart, Boolean) | |
| SetIsShared(WebPart, Boolean) | |
| SetIsShared(WebPartConnection, Boolean) |
Définit la propriété IsShared d'un objet WebPartConnection. |
| SetIsStandalone(WebPart, Boolean) |
Définit la propriété IsStandalone d'un contrôle WebPart. |
| SetIsStatic(WebPart, Boolean) | |
| SetIsStatic(WebPartConnection, Boolean) |
Définit la propriété IsStatic d'un objet WebPartConnection. |
| SetTransformer(WebPartConnection, WebPartTransformer) |
Affecte un objet WebPartTransformer à utiliser dans une connexion entre deux contrôles serveur. |
| SetZoneID(WebPart, String) |
Définit une propriété qui permet à un contrôle WebPart ou à un contrôle serveur de conserver l'ID de la zone conteneur. |
| SetZoneIndex(WebPart, Int32) |
Définit l’index du contrôle spécifié dans sa zone par rapport aux autres contrôles WebPart dans la zone. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
