Cómo: Proporcionar controles de elementos Web opcionales

  • Artículo

Actualización: noviembre 2007

Una característica del conjunto de controles de elementos Web es la posibilidad de hacer que esté disponible un catálogo de controles opcionales para que un usuario final los agregue a una página.

Nota:

Debe proporcionar una manera de que los usuarios finales vean la página en modo de catálogo, para que puedan ver el catálogo. Para ello, puede establecer la propiedad DisplayMode de la instancia de WebPartManager local en modo de catálogo, como se describe en Cómo: Establecer el modo de presentación de una página de elementos Web. Alternativamente, puede crear un control de usuario que exponga todos los modos de presentación de página disponibles y proporcione otra funcionalidad útil. Para obtener más información, vea Tutorial: Cambiar los modos de presentación en una página de elementos Web.

Para crear un catálogo de controles de elementos Web opcionales

  1. Cree una página de elementos Web ASP.NET con la personalización habilitada. Para obtener información detallada, vea Tutorial: Crear una página de elementos Web.

  2. Agregue a la página una zona WebPartZone que contenga una plantilla ZoneTemplate. Aquí es donde el usuario colocará los controles que seleccione.

  3. Agregue a la página una zona CatalogZone que contenga una plantilla ZoneTemplate que a su vez contenga un control DeclarativeCatalogPart.

  4. Dentro del control DeclarativeCatalogPart, agregue un par de etiquetas <WebPartsTemplate> que contengan los controles que se incluirán en el catálogo. Ahora, el marcado para la zona CatalogZone debería tener una apariencia similar al del ejemplo siguiente.

    <asp:CatalogZone ID="CZ1" >
    <ZoneTemplate>
        <asp:DeclarativeCatalogPart ID="DCP1" >
            <WebPartsTemplate>
                <asp:Label ID="Label1"  Text="Label" />
                <asp:Button ID="Button1"  Text="Button" />
            </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
    </ZoneTemplate>
</asp:CatalogZone>

    <asp:CatalogZone ID="CZ1" >
    <ZoneTemplate>
        <asp:DeclarativeCatalogPart ID="DCP1" >
            <WebPartsTemplate>
                <asp:Label ID="Label1"  Text="Label" />
                <asp:Button ID="Button1"  Text="Button" />
            </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
    </ZoneTemplate>
</asp:CatalogZone>

    Los controles incluidos en el control DeclarativeCatalogPart estarán disponibles para el usuario final cuando la página se vea en modo de catálogo.

Vea también

Tareas

Tutorial: Cambiar los modos de presentación en una página de elementos Web

Cómo: Establecer el modo de presentación de una página de elementos Web

Referencia

DeclarativeCatalogPart

CatalogZone

WebPartZone

WebPartManager.DisplayMode