WebPartManager.CopyWebPart(WebPart) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wordt door het besturingselement Webonderdelen gebruikt om een kopie van een WebPart of serverbeheer te maken om het besturingselement toe te voegen aan een webpagina.
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 WebPartParameters
Retouren
Een WebPart te toevoegen aan een pagina.
Opmerkingen
U kunt de CopyWebPart methode niet rechtstreeks vanuit uw code aanroepen. Deze methode wordt intern aangeroepen door het WebPartManager besturingselement als onderdeel van het proces voor het toevoegen van een nieuw dynamisch WebPart of serverbeheer aan een pagina. Een dynamisch besturingselement wordt programmatisch of via de gebruikersinterface van webonderdelen aan een pagina toegevoegd, bijvoorbeeld door een gebruiker een besturingselement toe te voegen vanuit een catalogus met besturingselementen, in plaats van een statisch besturingselement, dat rechtstreeks in de opmaak van een pagina wordt gedeclareerd.
Note
De methode kan worden overschreven in een afgeleide klasse als ontwikkelaars de methode willen inschakelen voor het afhandelen van aanvullende scenario's voor het kopiëren van besturingselementen. Zie de sectie Notities voor overnames voor meer informatie.
Wanneer een nieuw dynamisch besturingselement wordt toegevoegd, als het een WebPart besturingselement is, retourneert de CopyWebPart methode een nieuw exemplaar van het besturingselement. Als het besturingselement dat wordt toegevoegd een ander type serverbesturingselement is (zoals een gebruikersbesturingselement, een aangepast besturingselement of een ASP.NET besturingselement), is het besturingselement al verpakt met een GenericWebPart-object door de besturingsset webonderdelen. Wanneer de CopyWebPart methode een GenericWebPart besturingselement tegenkomt, retourneert deze een nieuw exemplaar van het GenericWebPart besturingselement met een nieuw exemplaar van het onderliggende besturingselement dat erin is verpakt.
Wanneer met de CopyWebPart methode een nieuwe kopie van een besturingselement wordt gemaakt die moet worden geretourneerd, worden ook de waarden van alle eigenschappen opnieuw ingesteld op de standaardwaarden. Als u de waarden van de persoonlijke eigenschappen wilt behouden en deze naar het nieuwe besturingselementexemplaren wilt laten kopiëren, moet u ook de CopyPersonalizationState methode aanroepen. De laatste stap die door de CopyWebPart methode wordt uitgevoerd, is het aanroepen van de CreateDynamicWebPartID methode om een nieuwe id voor het besturingselement te verkrijgen.
Note
Omdat de methode een nieuwe id voor een gekopieerd besturingselement verkrijgt, moet u niet vertrouwen op het verwijzen naar een dynamisch besturingselement dat door de oorspronkelijke id aan een pagina wordt toegevoegd. In plaats daarvan moet u verwijzen naar het nieuwe exemplaar van het besturingselement dat door de methode wordt geretourneerd.
Notities voor overnemers
De methode wordt gedeclareerd als virtual zodanig dat ontwikkelaars de klasse kunnen overnemen WebPartManager , de methode kunnen overschrijven en aanvullende scenario's kunnen bieden waarin kopieën van besturingselementen kunnen worden gemaakt. De methode kan bijvoorbeeld optioneel worden ontvangen als invoer van een besturingselement dat is geserialiseerd in een XML-bestand. De methode kan de XML deserialiseren (indien aanwezig) en vervolgens de basismethode aanroepen om de bestaande gevallen af te handelen en een nieuw exemplaar van een WebPart besturingselement te retourneren.
