Compartir a través de


WebPartManager.CopyWebPart(WebPart) Método

Definición

Las utiliza el conjunto de controles de elementos Web para crear una copia de un control WebPart o un control de servidor para el fin de agregar el control a una página 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

Parámetros

webPart
WebPart

Control WebPart o control de servidor que se va a copiar.

Devoluciones

Objeto WebPart que se agrega una página.

Comentarios

No se puede llamar al método directamente desde el CopyWebPart código. El control llama a este método internamente WebPartManager como parte del proceso de agregar un nuevo control dinámico WebPart o de servidor a una página. Un control dinámico se agrega a una página mediante programación o a través de la interfaz de usuario (UI) de elementos web, por ejemplo, mediante la adición de un control desde un catálogo de controles, en lugar de un control estático, que se declara directamente en el marcado de una página.

Nota

El método se puede invalidar en una clase derivada si los desarrolladores quieren habilitar el método para controlar escenarios de copia de controles adicionales. Para obtener más información, consulte la sección Notas a heredar.

Cuando se agrega un nuevo control dinámico, si es un WebPart control , el CopyWebPart método devuelve una nueva instancia del control. Si el control que se va a agregar es algún otro tipo de control de servidor (como un control de usuario, un control personalizado o un control ASP.NET), el control ya se habrá encapsulado con un GenericWebPart objeto por el conjunto de controles de elementos web. Cuando el CopyWebPart método encuentra un GenericWebPart control, devuelve una nueva instancia del GenericWebPart control con una nueva instancia del control secundario encapsulado dentro de él.

Cuando el CopyWebPart método crea una nueva copia de un control que se va a devolver, también restablece los valores de todas las propiedades a sus valores predeterminados. Tenga en cuenta que, si desea conservar los valores de las propiedades personalizables y hacer que se copien en la nueva instancia de control, también debe llamar al CopyPersonalizationState método . El último paso realizado por el CopyWebPart método es llamar al CreateDynamicWebPartID método para obtener un nuevo identificador para el control.

Nota

Dado que el método obtiene un nuevo identificador para un control copiado, no debe confiar en hacer referencia a un control dinámico que se agrega a una página por su identificador original. En su lugar, debe hacer referencia a la nueva instancia del control devuelto por el método .

Notas a los desarrolladores de herederos

El método se declara como virtual para que los desarrolladores puedan heredar de la WebPartManager clase , invalidar el método y proporcionar escenarios adicionales en los que podría crear copias de los controles. Por ejemplo, el método podría recibir opcionalmente como entrada un control que se ha serializado en un archivo XML. El método podría deserializar el XML (si está presente) y, a continuación, llamar al método base para controlar los casos existentes y devolver una nueva instancia de un WebPart control.

Se aplica a

Consulte también