WebPartManager.CopyWebPart(WebPart) Methode

Definition

Wird vom Webparts-Steuerelementsatz verwendet, um eine Kopie eines WebPart-Steuerelements oder Serversteuerelements anzulegen und diese dem Steuerelement auf 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.WebPart
Protected Overridable Function CopyWebPart (webPart As WebPart) As WebPart

Parameter

webPart
WebPart

Das zu kopierende WebPart-Steuerelement oder Serversteuerelement.

Gibt zurück

Ein WebPart, der einer Seite hinzugefügt werden soll.

Hinweise

Sie können die CopyWebPart -Methode nicht direkt aus Ihrem 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 Webparts-Benutzeroberfläche hinzugefügt, z. B. indem ein Benutzer ein Steuerelement aus einem Steuerelementkatalog hinzufügt, im Gegensatz zu einem statischen Steuerelement, das direkt im Markup einer Seite deklariert wird.

Hinweis

Die -Methode kann in einer abgeleiteten Klasse überschrieben werden, wenn Entwickler die -Methode aktivieren möchten, um zusätzliche Kontrollkopierszenarien zu verarbeiten. Ausführliche Informationen finden Sie im Abschnitt Hinweise zu Erben.

Wenn ein neues dynamisches Steuerelement hinzugefügt wird und es sich um ein WebPart Steuerelement handelt, gibt die CopyWebPart Methode eine neue Instanz des Steuerelements zurück. Wenn es sich bei dem hinzugefügten Steuerelement um einen anderen Typ von Serversteuerelement handelt (z. B. ein Benutzersteuerelement, ein benutzerdefiniertes Steuerelement oder ein ASP.NET-Steuerelement), wurde das Steuerelement bereits vom Webparts-Steuerelementsatz mit einem GenericWebPart -Objekt umschlossen. Wenn die CopyWebPart Methode auf ein GenericWebPart Steuerelement trifft, gibt sie eine neue Instanz des GenericWebPart Steuerelements mit einer neuen Instanz des untergeordneten Steuerelements zurück, das darin eingeschlossen ist.

Wenn die CopyWebPart -Methode eine neue Kopie eines Steuerelements erstellt, das zurückgegeben werden soll, 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 kopieren möchten, sollten Sie auch die CopyPersonalizationState -Methode aufrufen. Der letzte Schritt, der von der CopyWebPart -Methode ausgeführt wird, besteht darin, die CreateDynamicWebPartID -Methode aufzurufen, um eine neue ID für das Steuerelement zu erhalten.

Hinweis

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 als virtual deklariert, damit Entwickler von der WebPartManager -Klasse erben, die -Methode überschreiben und zusätzliche Szenarien bereitstellen können, in denen Kopien von Steuerelementen erstellt werden können. Beispielsweise könnte die -Methode optional als Eingabe ein Steuerelement empfangen, das in eine XML-Datei serialisiert wurde. Die -Methode könnte den XML-Code deserialisieren (falls vorhanden) und dann die Basismethode aufrufen, um die vorhandenen Fälle zu behandeln und eine neue Instanz eines WebPart Steuerelements zurückzugeben.

Gilt für:

Weitere Informationen