Adaptadores y páginas de elementos web móviles

Última modificación: miércoles, 02 de febrero de 2011

Hace referencia a: SharePoint Foundation 2010

En este tema se ofrece una introducción al marco de trabajo de adaptadores de SharePoint Foundation para representar elementos web en dispositivos móviles.

Adaptación móvil de SharePoint Foundation

Los programadores pueden poner a disposición páginas de elementos web en sitios web de SharePoint Foundation para que puedan obtener acceso a ellas los dispositivos móviles mediante una variante del sistema de adaptación móvil de Microsoft ASP.NET 3.5. El sistema de adaptación móvil de SharePoint Foundation es básicamente el mismo:

1. Cuando se solicita una página de elementos web, el servidor front-end web detecta, desde el encabezado de solicitud, qué tipo de dispositivo realiza la solicitud.

2. Si un dispositivo móvil realiza la solicitud, ASP.NET busca cada elemento web en la página solicitada del archivo compat.browser para averiguar qué adaptador móvil está asociado él, si es que hay alguno.

3. En cada uno de los eventos, Init, Load, PreRender y UnLoad(), si un elemento web tiene un adaptador móvil, se llamará al controlador del adaptador del evento en lugar de al controlador propio del elemento web, aunque normalmente el controlador del adaptador llamará al controlador del elemento web como parte de su lógica.

4. En SharePoint Foundation, la implementación del controlador del adaptador en los cuatro eventos comprueba si la página actual es un objeto WebPartMobilePage. Si lo es, el tiempo de ejecución llamará al método On*ForMobile correspondiente: OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) o OnUnloadForMobile(EventArgs).

Para obtener más información acerca del sistema de adaptación móvil de Microsoft ASP.NET 3.5, vea Architectural Overview of Adaptive Control Behavior, Browser Definition File Schema (browsers Element) y System.Web.UI.Adapters.ControlAdapter.

Programación de SharePoint Foundation Mobile Adaption Framework

En realidad, es más simple desarrollar en el marco de SharePoint Foundation para adaptadores móviles que en el sistema de adaptación móvil de Microsoft ASP.NET 3.5. Al igual que en el sistema de Microsoft ASP.NET 3.5, se crea un control de adaptador móvil para cada elemento web que se desea que esté accesible para dispositivos móviles y se asignará ese adaptador al elemento web cuya representación adapta en el archivo compat.browser.

Sin embargo, el desarrollo con el marco de SharePoint Foundation difiere del desarrollo de adaptadores móviles con Microsoft ASP.NET 3.5 en algunos aspectos. En su mayoría, estas diferencias son necesarias para cumplir con el modelo de seguridad de SharePoint Foundation:

• La clase de adaptador deriva de Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter en lugar de derivar directamente de System.Web.UI.Adapters.ControlAdapter.

• La clase de adaptador debe estar registrada como un control seguro. Para obtener más información sobre cómo hacerlo, vea Trabajo con archivos Web.config.

• No se debe invalidar el método Render(HtmlTextWriter) heredado de ControlAdapter. En su lugar, se debe invalidar uno o ambos de los métodos CreateControlsForSummaryView() y CreateControlsForDetailView().

• No se deben invalidar los métodos OnLoad(EventArgs), OnInit(EventArgs), OnPreRender(EventArgs) y OnUnload(EventArgs) que Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter hereda de ControlAdapter. En su lugar, si necesita lógica adicional para cualquiera de estos eventos, debe invalidar uno o varios de los métodos de reemplazo seguros de SharePoint especiales de Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter: OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) y OnUnloadForMobile(EventArgs).

  Importante
  Vea los temas de referencia de estos cuatro métodos para obtener información importante acerca de cómo invalidarlos.

• Las páginas de elementos web accesibles para dispositivos móviles son objetos de la clase WebPartMobilePage, pero no debe crearlos. Cuando un usuario del dispositivo móvil navega a una página de elementos web que contiene elementos web que han sido adaptados para dispositivos móviles, el tiempo de ejecución crea un objeto WebPartMobilePage y lo devuelve al dispositivo móvil.

• Cada página de elementos web, que contiene los elementos web que se han adaptado para dispositivos móviles, tiene una página de aplicación correspondiente donde se puede establecer la visibilidad y el orden de los elementos web adaptados. Estas páginas son objetos del tipo WebPartMobileSettingPage y también se crean en tiempo de ejecución cuando un usuario navega a una de ellas (normalmente al hacer clic en un botón de la cinta de opciones de una página de elementos web), por lo que tampoco se deben crear estos objetos.

Vea también

Referencia

System.Web.UI.Adapters.ControlAdapter

Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter

Conceptos

Trabajo con archivos Web.config

Otros recursos

Architectural Overview of Adaptive Control Behavior

Browser Definition File Schema (browsers Element)