WebPartManager.CopyWebPart(WebPart) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird vom Steuerelement "Webparts" verwendet, um eine Kopie eines Steuerelements oder Servers WebPart zu erstellen, um das Steuerelement einer Webseite hinzuzufügen.
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 WebPartParameter
Gibt zurück
A WebPart , das einer Seite hinzugefügt werden soll.
Hinweise
Sie können die CopyWebPart Methode nicht direkt aus Dem Code aufrufen. Diese Methode wird intern vom WebPartManager Steuerelement als Teil des Prozesses zum Hinzufügen eines neuen dynamischen WebPart oder Serversteuerelements zu einer Seite aufgerufen. Ein dynamisches Steuerelement wird einer Seite programmgesteuert oder über die Benutzeroberfläche von Webparts hinzugefügt, z. B. durch einen Benutzer, der ein Steuerelement aus einem Steuerelementkatalog hinzufügt, im Gegensatz zu einem statischen Steuerelement, das direkt im Markup einer Seite deklariert wird.
Note
Die Methode kann in einer abgeleiteten Klasse überschrieben werden, wenn Entwickler die Methode aktivieren möchten, um zusätzliche Kopierszenarien für Steuerelemente zu verarbeiten. Ausführliche Informationen finden Sie im Abschnitt "Hinweise zu Vererbungen".
Wenn ein neues dynamisches Steuerelement hinzugefügt wird, wenn es sich um ein WebPart Steuerelement handelt, gibt die CopyWebPart Methode eine neue Instanz des Steuerelements zurück. Wenn das hinzugefügte Steuerelement ein anderer Serversteuerelementtyp ist (z. B. ein Benutzersteuerelement, ein benutzerdefiniertes Steuerelement oder ein ASP.NET-Steuerelement), wurde das Steuerelement bereits mit einem GenericWebPart-Objekt durch den Steuerelementsatz "Webparts" umschlossen. Wenn die CopyWebPart Methode auf ein GenericWebPart Steuerelement trifft, wird eine neue Instanz des GenericWebPart Steuerelements mit einer neuen Instanz des darin eingeschlossenen untergeordneten Steuerelements zurückgegeben.
Wenn die CopyWebPart Methode eine neue Kopie eines zurückzugebenden Steuerelements erstellt, setzt sie auch die Werte aller Eigenschaften auf ihre Standardwerte zurück. Wenn Sie die Werte der personalisierbaren Eigenschaften beibehalten und in die neue Steuerelementinstanz kopiert haben möchten, sollten Sie auch die CopyPersonalizationState Methode aufrufen. Der letzte Schritt der CopyWebPart Methode besteht darin, die CreateDynamicWebPartID Methode aufzurufen, um eine neue ID für das Steuerelement abzurufen.
Note
Da die Methode eine neue ID für ein kopiertes Steuerelement abruft, sollten Sie sich nicht darauf verlassen, auf ein dynamisches Steuerelement zu verweisen, das einer Seite mit seiner ursprünglichen ID hinzugefügt wird. Stattdessen sollten Sie auf die neue Instanz des Steuerelements verweisen, das von der Methode zurückgegeben wird.
Hinweise für Vererber
Die Methode wird so deklariert virtual , dass Entwickler von der WebPartManager Klasse erben, die Methode außer Kraft setzen und zusätzliche Szenarien bereitstellen können, in denen Kopien von Steuerelementen erstellt werden können. Die Methode kann z. B. optional als Eingabe eines Steuerelements empfangen, das in eine XML-Datei serialisiert wurde. Die Methode könnte den XML-Code (sofern vorhanden) deserialisieren und dann die Basismethode aufrufen, um die vorhandenen Fälle zu behandeln und eine neue Instanz eines WebPart Steuerelements zurückzugeben.
