WebPartManager.CopyWebPart(WebPart) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Används av webbdelskontrolluppsättningen för att skapa en kopia av en WebPart eller serverkontroll i syfte att lägga till kontrollen på en webbsida.
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 WebPartParametrar
Returer
En WebPart som ska läggas till på en sida.
Kommentarer
Du kan inte anropa CopyWebPart metoden direkt från koden. Den här metoden anropas internt av WebPartManager kontrollen som en del av processen att lägga till en ny dynamisk WebPart kontroll eller serverkontroll på en sida. En dynamisk kontroll läggs till på en sida programmatiskt eller via användargränssnittet för webbdelar ,till exempel av en användare som lägger till en kontroll från en katalog med kontroller, i motsats till en statisk kontroll, som deklareras direkt i markering av en sida.
Note
Metoden kan åsidosättas i en härledd klass om utvecklare vill aktivera metoden för att hantera ytterligare scenarier för kontrollkopiering. Mer information finns i avsnittet Anteckningar till arvtagare.
När en ny dynamisk kontroll läggs till returnerar metoden en ny instans av kontrollen om det är en WebPart kontroll CopyWebPart . Om kontrollen som läggs till är någon annan typ av serverkontroll (till exempel en användarkontroll, en anpassad kontroll eller en ASP.NET kontroll) har kontrollen redan omslutits med ett GenericWebPart objekt av kontrolluppsättningen webbdelar. CopyWebPart När metoden påträffar en GenericWebPart kontroll returneras en ny instans av GenericWebPart kontrollen med en ny instans av den underordnade kontrollen omsluten i den.
CopyWebPart När metoden skapar en ny kopia av en kontroll som ska returneras återställs även värdena för alla egenskaper till deras standardvärden. Observera att om du vill bevara värdena för de personliga egenskaperna och kopiera dem till den nya kontrollinstansen CopyPersonalizationState bör du även anropa metoden. Det sista steget som utförs av CopyWebPart metoden är att anropa CreateDynamicWebPartID metoden för att hämta ett nytt ID för kontrollen.
Note
Eftersom metoden hämtar ett nytt ID för en kopierad kontroll bör du inte förlita dig på att referera till en dynamisk kontroll som läggs till på en sida med dess ursprungliga ID. I stället bör du referera till den nya instansen av kontrollen som returneras av metoden.
Anteckningar till arvingar
Metoden deklareras som virtual så att utvecklare kan ärva från WebPartManager klassen, åsidosätta metoden och ange ytterligare scenarier där den kan skapa kopior av kontroller. Metoden kan till exempel ta emot som indata en kontroll som har serialiserats till en XML-fil. Metoden kan deserialisera XML (om den finns) och sedan anropa basmetoden för att hantera de befintliga fallen och returnera en ny instans av en WebPart kontroll.
