WebPartManager.CopyWebPart(WebPart) 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.
Utilisé par le contrôle Composants WebPart pour créer une copie d’un contrôle serveur ou d’un WebPart contrôle dans le but d’ajouter le contrôle à une page Web.
protected:
virtual System::Web::UI::WebControls::WebParts::WebPart ^ CopyWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);protected virtual System.Web.UI.WebControls.WebParts.WebPart CopyWebPart(System.Web.UI.WebControls.WebParts.WebPart webPart);abstract member CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPart
override this.CopyWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartProtected Overridable Function CopyWebPart (webPart As WebPart) As WebPartParamètres
Retours
À WebPart ajouter à une page.
Remarques
Vous ne pouvez pas appeler la CopyWebPart méthode directement à partir de votre code. Cette méthode est appelée en interne par le WebPartManager contrôle dans le cadre du processus d’ajout d’un nouveau contrôle dynamique WebPart ou serveur à une page. Un contrôle dynamique est ajouté à une page par programmation ou via l’interface utilisateur des composants WebPart, par exemple par un utilisateur ajoutant un contrôle à partir d’un catalogue de contrôles, par opposition à un contrôle statique, qui est déclaré directement dans le balisage d’une page.
Note
La méthode peut être substituée dans une classe dérivée si les développeurs souhaitent activer la méthode pour gérer des scénarios de copie de contrôle supplémentaires. Pour plus d’informations, consultez la section Notes to Inheritors.
Lorsqu’un nouveau contrôle dynamique est ajouté, s’il s’agit d’un WebPart contrôle, la CopyWebPart méthode retourne une nouvelle instance du contrôle. Si le contrôle ajouté est un autre type de contrôle serveur (par exemple, un contrôle utilisateur, un contrôle personnalisé ou un contrôle ASP.NET), le contrôle a déjà été encapsulé avec un objet GenericWebPart par le jeu de contrôles Composants WebPart. Lorsque la CopyWebPart méthode rencontre un GenericWebPart contrôle, elle retourne une nouvelle instance du GenericWebPart contrôle avec une nouvelle instance du contrôle enfant encapsulée.
Lorsque la CopyWebPart méthode crée une nouvelle copie d’un contrôle à retourner, elle réinitialise également les valeurs de toutes les propriétés à leurs valeurs par défaut. Notez que, si vous souhaitez conserver les valeurs des propriétés personalisables et les copier dans la nouvelle instance de contrôle, vous devez également appeler la CopyPersonalizationState méthode. La dernière étape effectuée par la CopyWebPart méthode consiste à appeler la CreateDynamicWebPartID méthode pour obtenir un nouvel ID pour le contrôle.
Note
Étant donné que la méthode obtient un nouvel ID pour un contrôle copié, vous ne devez pas compter sur le référencement d’un contrôle dynamique ajouté à une page par son ID d’origine. Au lieu de cela, vous devez référencer la nouvelle instance du contrôle retourné par la méthode.
Notes pour les héritiers
La méthode est déclarée de virtual sorte que les développeurs puissent hériter de la WebPartManager classe, remplacer la méthode et fournir des scénarios supplémentaires dans lesquels il peut créer des copies de contrôles. Par exemple, la méthode peut éventuellement recevoir comme entrée un contrôle sérialisé dans un fichier XML. La méthode peut désérialiser le code XML (le cas échéant), puis appeler la méthode de base pour gérer les cas existants et retourner une nouvelle instance d’un WebPart contrôle.
