WebPartZone.GetInitialWebParts 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í.
Reemplaza el método base abstracto y obtiene el conjunto inicial de controles WebPart estáticos contenido dentro de la plantilla de la zona.
protected public:
override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionDevoluciones
Una colección WebPartCollection que contiene todos los controles WebPart y demás controles de servidor contenidos en la plantilla de la zona.
Comentarios
El GetInitialWebParts método proporciona una implementación del método base GetInitialWebParts abstracto. El método base no proporciona ninguna implementación, pero declara el método para que las clases derivadas puedan personalizar cómo obtendrán el conjunto inicial de controles que pertenecen a una zona, sin tener en cuenta los cambios de personalización.
Para cada control de servidor que se encuentra en la zona, se llama al CreateWebPart método . Si un control hereda directamente de la WebPart clase , simplemente se agrega a la colección de WebParts la zona (y a la colección similar del WebPartManager control). Si un control no hereda directamente de WebPart, el conjunto de controles elementos web ajusta el control con un GenericWebPart objeto , lo que permite que el control se comporte como un WebPart control en tiempo de ejecución.
La WebPartZone clase implementa el método base devolviendo el conjunto de controles (si existe) que se declaran estáticamente dentro de un conjunto de <zonetemplate> etiquetas en el marcado de una página de elementos web. Si un PlaceHolder control se declara en una zona, se agregan los controles secundarios de ese control, en lugar del propio control. Esta implementación le permite, por ejemplo, crear una WebPartZone zona en una página maestra y, a continuación, declarar controles individuales WebPart o de servidor en una página de contenido. Si declara Literal controles en una WebPartZone zona, se omiten.
Nota
La colección inicial de controles devueltos por el GetInitialWebParts método podría ser diferente de la colección en tiempo de ejecución real de los controles de una zona, después de que se haya realizado la personalización. Por ejemplo, supongamos que tiene una página web con dos WebPartZone controles y la primera contiene el control de usuario denominado User1 que se declara estáticamente dentro de las <zonetemplate> etiquetas. Si un usuario carga la página y se arrastra User1 a la segunda zona, User1 sigue siendo parte de la colección que se devuelve llamando al GetInitialWebParts método para la primera zona, ya que se declara en esa zona. Pero en tiempo de ejecución, cuando el WebPartManager control carga los datos de personalización, User1 realmente aparece en la segunda zona donde el usuario lo arrastró.