WebPartManager.CopyWebPart(WebPart) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Usado por el conjunto de controles de elementos web para crear una copia de un WebPart control de servidor o para 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.WebPartProtected Overridable Function CopyWebPart (webPart As WebPart) As WebPartParámetros
Devoluciones
que WebPart se va a agregar a una página.
Comentarios
No se puede llamar al CopyWebPart método directamente desde el código. El control llama internamente a WebPartManager este método 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.
Note
El método se puede invalidar en una clase derivada si los desarrolladores desean 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 objeto GenericWebPart 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 ajustada 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 llevado a cabo por el CopyWebPart método es llamar al CreateDynamicWebPartID método para obtener un nuevo identificador para el control.
Note
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 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.
