WebPartZone.GetInitialWebParts Méthode
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.
Substitue la méthode de base abstraite et obtient le jeu de contrôles WebPart statiques initial contenu dans le modèle de la zone.
protected public:
override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionRetours
WebPartCollection qui contient tous les contrôles WebPart ou autres contrôles serveur contenus dans le modèle de la zone.
Remarques
La GetInitialWebParts méthode fournit une implémentation de la méthode de base GetInitialWebParts abstraite. La méthode de base ne fournit aucune implémentation, mais déclare la méthode afin que les classes dérivées puissent personnaliser la façon dont elles obtiendront l’ensemble initial de contrôles appartenant à une zone, sans prendre en compte les modifications de personnalisation.
Pour chaque contrôle serveur trouvé dans la zone, la CreateWebPart méthode est appelée. Si un contrôle hérite directement de la WebPart classe, il est simplement ajouté à la collection de WebParts la zone (et à la collection similaire du WebPartManager contrôle). Si un contrôle n’hérite pas directement de WebPart, le jeu de contrôles composants WebPart encapsule le contrôle avec un GenericWebPart objet, ce qui permet au contrôle de se comporter en tant que WebPart contrôle au moment de l’exécution.
La WebPartZone classe implémente la méthode de base en retournant le jeu de contrôles (le cas échéant) qui sont déclarés statiquement dans un ensemble de <zonetemplate> balises dans le balisage d’une page composants WebPart. Si un PlaceHolder contrôle est déclaré dans une zone, les contrôles enfants de ce contrôle sont ajoutés, plutôt que le contrôle lui-même. Cette implémentation vous permet, par exemple, de créer une WebPartZone zone dans une page maître, puis de déclarer des contrôles individuels WebPart ou serveurs dans une page de contenu. Si vous déclarez Literal des contrôles dans une WebPartZone zone, ils sont ignorés.
Notes
La collection initiale de contrôles retournée par la GetInitialWebParts méthode peut être différente de la collection réelle de contrôles au moment de l’exécution dans une zone, une fois la personnalisation effectuée. Par exemple, supposons que vous disposez d’une page Web avec deux WebPartZone contrôles, et que le premier contient le contrôle utilisateur nommé User1 qui est déclaré statiquement dans les <zonetemplate> balises. Si un utilisateur charge la page et fait glisser User1 dans la deuxième zone, User1 il fait toujours partie de la collection retournée en appelant la GetInitialWebParts méthode pour la première zone, car elle est déclarée dans cette zone. Mais au moment de l’exécution, lorsque le WebPartManager contrôle charge les données de personnalisation, User1 apparaît réellement dans la deuxième zone où l’utilisateur l’a déplacé.