WebPartManager.CopyWebPart(WebPart) Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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

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

Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

Paramètres

webPart: WebPart

WebPart ou contrôle serveur à copier.

Retours

WebPart

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 contrôle dans le WebPartManager 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 de composants WebPart, par exemple par un utilisateur qui ajoute 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.

Notes

La méthode peut être remplacée dans une classe dérivée si les développeurs souhaitent autoriser la méthode à gérer des scénarios de copie de contrôle supplémentaires. Pour plus d’informations, consultez la section Notes à l’attention des héritiers.

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 aura déjà été encapsulé avec un GenericWebPart objet par le jeu de contrôles 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 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 personnalisables et les faire 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.

Notes

Étant donné que la méthode obtient un nouvel ID pour un contrôle copié, vous ne devez pas vous appuyer 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 afin virtual que les développeurs puissent hériter de la WebPartManager classe, remplacer la méthode et fournir des scénarios supplémentaires dans lesquels elle peut créer des copies de contrôles. Par exemple, la méthode peut éventuellement recevoir en tant qu’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.

S’applique à

Partager via