Bloque de creación: Páginas, controles y adaptadores móviles
Última modificación: viernes, 19 de marzo de 2010
Hace referencia a: SharePoint Foundation 2010
En este artículo
Modelo de objetos para páginas, controles y adaptadores móviles
XML usado para páginas, controles, adaptadores y visores de documentos móviles
Áreas relacionadas con el desarrollo de páginas, controles y adaptadores móviles
Más información sobre el desarrollo de páginas, controles y adaptadores móviles
En este tema se proporciona una breve introducción al uso de páginas, controles y adaptadores móviles como bloques de creación de desarrollo en Microsoft SharePoint Foundation.
Para que las implementaciones de SharePoint Foundation sean accesibles para los dispositivos móviles, SharePoint Foundation proporciona un conjunto de páginas móviles y controles móviles totalmente independiente de las páginas y los controles accesibles desde los equipos que no son móviles. Ciertos elementos web también son accesibles para los dispositivos móviles mediante adaptadores de elementos web móviles.
Cuando un dispositivo móvil navega a una dirección URL de SharePoint Foundation, SharePoint Foundation detecta el tipo de explorador en el encabezado de la solicitud y la redirige a una versión móvil de la página. La página móvil tiene controles móviles que normalmente reflejan la funcionalidad de los controles en la versión no móvil de la página. Si la página que no es móvil es una página de elementos web, es posible que la página móvil tenga adaptadores para uno o varios de los elementos web de la página no móvil. Un adaptador es una versión alternativa del elemento web y sus controles secundarios que se presenta de forma adecuada en la pantalla pequeña del dispositivo móvil.
Puede crear sus propias páginas, controles y adaptadores móviles personalizados para que las soluciones de SharePoint Foundation sean accesibles desde dispositivos móviles.
Modelo de objetos para páginas, controles y adaptadores móviles
Las clases para el desarrollo de dispositivos móviles se dividen en tres amplios grupos que se describen en los subapartados siguientes.
Clases de página móvil
Las páginas móviles de SharePoint Foundation no usan páginas maestras. Además, la distinción entre páginas de sitio y páginas de aplicación no se aplica en el desarrollo de SharePoint Foundation para dispositivos móviles. Todas las páginas móviles de SharePoint Foundation son páginas de aplicación. No se ejecutan en el modo seguro.
Todas las páginas móviles de SharePoint Foundation heredan, de forma directa o indirecta, de alguna de las clases siguientes:
SPMobilePage – Use esta clase como clase base para su página móvil personalizada cuando no se pueda aplicar ninguna de las clases más específicas siguientes.
SPMoblogPage – Use esta clase como clase base para páginas móviles personalizadas que son parte de sitios blog.
WebPartMobilePage – Use esta clase como clase base para páginas de elementos web móviles personalizadas. Debe haber un objeto WebPartPage no móvil correspondiente, llamado página de destino, para cada objeto WebPartMobilePage. Cada elemento web de la página de destino para la que se ha creado un adaptador móvil se presenta en la versión móvil de la página.
SPMobileWikiPage – Use esta clase, que deriva de WebPartMobilePage, como clase base para páginas wiki móviles personalizadas. Por cada página de este tipo, debe haber una página wiki de destino correspondiente. Cada elemento web de la página de destino para la que se ha creado un adaptador móvil se presenta en la versión móvil de dicha página.
Además de crear sus propias páginas móviles, puede modificar el sistema de redirección que redirige las solicitudes de dispositivos móviles a páginas móviles. Para obtener más información, vea Introducción a las páginas móviles y el sistema de redirección, Páginas móviles, Diseño y paginación de las páginas móviles y Procedimiento para personalizar la página principal móvil mediante redireccionamiento. Para obtener más información sobre el desarrollo de páginas móviles en general, vea también Procedimiento para personalizar las páginas principales móviles, Procedimiento para personalizar las páginas de vista de lista móvil y formulario y Procedimiento para personalizar la representación de campos en páginas móviles.
Clases de control móvil
Hay cerca de 200 clases en el espacio de nombres Microsoft.SharePoint.MobileControls. Estas clases, heredan en última instancia de la clase Microsoft ASP.NET System.Web.UI.MobileControls.MobileControl. Con pocas excepciones, la ascendencia de la herencia de un control móvil de SharePoint Foundation incluye SPMobileComponent. Esta clase proporciona varios tipos de miembros a los controles móviles de SharePoint Foundation, que incluyen los siguientes:
Miembros que proporcionan información de contexto de SharePoint Foundation, como el sitio web actual, la lista actual, el tipo de página y los permisos del usuario actual.
Miembros que administran el sistema de truncado que se usa cuando un control es demasiado grande o tiene demasiados elementos secundarios para entrar de forma legible en la pantalla de un dispositivo móvil.
Miembros que implementan el sistema de plantilla de presentación que presenta los controles.
Nota
SPMobileComponent deriva inmediatamente de System.Web.UI.MobileControls.MobileControl, por lo que ninguna clase SharePoint Foundation que derive de SPMobileComponent puede derivar de ninguna clase de control móvil Microsoft ASP.NET específica, incluso aunque el nombre parezca indicar lo contrario. Por ejemplo, SPMobileListItem no deriva de System.Web.UI.MobileControls.MobileListItem. No obstante, hay algunas clases del espacio de nombres Microsoft.SharePoint.MobileControls que derivan directamente de las clases ASP.NET correspondientes y, en consecuencia, no derivan de SPMobileComponent, por ejemplo SPMobileLink.
No se hace referencia directa a la mayoría de los controles móviles de SharePoint Foundation en las páginas aspx móviles sino que son objetos secundarios de elementos RenderingTemplate del archivo MobileDefaultTemplates.ascx ubicado en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\ControlTemplates. A su vez, se hace referencia a la plantilla de presentación (que es un control de usuario de ASP.NET) en la propiedad TemplateName de un objeto que crea una instancia de clase que deriva de SPMobileComponent. La página móvil hace referencia a este último objeto. De hecho, suele ocurrir que la plantilla de presentación a la que hace referencia el objeto en la página es solo la primera de una cadena de plantillas de presentación dentro de MobileDefaultTemplates.ascx. Cada plantilla hace referencia a la siguiente, hasta llegar a la plantilla de presentación que contiene el control móvil secundario. En algunos casos, el control que se presenta en última instancia se selecciona de forma dinámica en función de información contextual como el tipo de sitio, tipo de página y tipo de lista.
En general, cuando se usan controles personalizados en la solución de SharePoint Foundation, se usa este mismo sistema: se agregan los controles personalizados a una plantilla de presentación personalizada en un archivo ascx en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\ControlTemplates y, después, se modifica el sistema de llamada para que la plantilla de presentación personalizada se use donde se desea en las páginas.
Para obtener más información sobre el desarrollo de controles móviles, veaIntroducción a las páginas móviles y el sistema de redirección, Sistema de representación de páginas móviles, Puntos suspensivos y límites de presentación, Procedimiento para personalizar las páginas principales móviles, Procedimiento para personalizar las páginas de vista de lista móvil y formulario, Procedimiento para personalizar la representación de campos en páginas móviles y los temas de los tutoriales del nodo Procedimientos y tutoriales para el desarrollo de elementos móviles del kit de desarrollo de software (SDK) de Microsoft SharePoint Foundation.
Clases de adaptador móvil
SharePoint Foundation usa el sistema ASP.NET de adaptadores de control para habilitar la funcionalidad de elementos web en páginas móviles. Todas las clases de adaptador móvil de SharePoint Foundation derivan de WebPartMobileAdapter, que, a su vez, deriva de la clase ASP.NETControlAdapter. Las modificaciones principales que hace la clase WebPartMobileAdapter a la clase ControlAdapterson cambios que están diseñados para bloquear el acceso directo al objeto de sistema de escritura HTML que presenta el elemento web. Estas modificaciones son necesarias por razones de seguridad.
No se hace referencia a los adaptadores de elementos web móviles en la página móvil sino que se asignan al elemento web que adaptan en un archivo de configuración. Cuando se presenta la página móvil que corresponde a una página de elementos web no móvil de destino, el tiempo de ejecución busca cada elemento web en la página de destino para ver si tiene un adaptador. Si lo tiene, se presenta el adaptador. Si no lo tiene, el elemento web no se presenta en la página móvil.
Los siguientes adaptadores de elementos web vienen incluidos en SharePoint Foundation:
Puede crear sus propios adaptadores de elementos web móviles personalizados para sus elementos web personalizados o para elementos web integrados en SharePoint Foundation.
Aunque las páginas móviles no se ejecuten en el modo seguro, debe registrar un adaptador de elemento web como control seguro al igual que los elementos web. Esto es para asegurar que alguien que no tiene derechos de edición sobre el archivo web.config no pueda usar una página móvil y un adaptador móvil para tener acceso a un elemento web que no es seguro.
Nota
SharePoint Foundation no admite la creación de adaptadores móviles para controles que no sean elementos web.
Para obtener información sobre el desarrollo de adaptadores móviles para SharePoint Foundation, vea Procedimiento para crear un adaptador móvil y Tutorial: Crear un adaptador móvil.
Clase de contexto móvil
La clase SPMobileContext es una clase práctica que encapsula propiedades del contexto HTTP actual que resultan especialmente útiles para el desarrollo de dispositivos móviles. Por ejemplo, la propiedad MarkupLanguage devuelve el nombre del idioma de presentación de la página que usa el explorador en el dispositivo móvil, como "html32", "chtml10", "xhtml-mp" o "wml11".
Miembros de redirección móvil
La clase UnsecuredLayoutsPageBase tiene miembros virtuales que implementan el sistema de solicitudes de redireccionamiento de solicitudes desde dispositivos móviles a la versión móvil de la página solicitada. Si deriva un tipo de página personalizado de UnsecuredLayoutsPageBase (que sería una página no móvil) y desea una versión móvil de instancias de la página que sea accesible para dispositivos móviles, pero la lógica de redirección predeterminada no es adecuada para el tipo de página, puede invalidar estos miembros.
Clase de utilidades móviles
La clase SPMobileUtility tiene decenas de métodos y campos estáticos para usar en el desarrollo de dispositivos móviles en SharePoint Foundation.
XML usado para páginas, controles, adaptadores y visores de documentos móviles
La mayoría de las vistas de lista no están bien diseñadas para su visualización en la pequeña pantalla de un dispositivo móvil. Por dicha razón, de forma predeterminada, solo pueden verse las vistas de lista que se han designado como vistas móviles en una página móvil. (No ocurre lo contrario. Es decir, una vista móvil puede verse en una página que no es móvil.) También puede haber una vista predeterminada de una lista para dispositivos móviles diferente de la vista predeterminada usada en exploradores de equipos.
Para designar una vista de lista como vista móvil, establezca el atributo MobileView del elemento Elemento View (List) en True. Para designar una vista móvil como vista móvil predeterminada, establezca el atributo MobileDefaultView del mismo elemento en True.
Si la solución incluye un visor que habilita documentos de tipos específicos para su visualización en dispositivos móviles aunque el formato no sea el formato de presentación del explorador del dispositivo, se puede crear una página móvil especial que hospede el visor y usa formato XML para registrar la página y, como opción, que permita a los dispositivos que contienen sus propios visores para el formato especificado abrir el documento directamente. Para obtener más información sobre este formato, vea Desarrollo de visores de documentos móviles.
Áreas relacionadas con el desarrollo de páginas, controles y adaptadores móviles
Bloque de creación: páginas e interfaz de usuario
Bloque de creación: elementos web
Más información sobre el desarrollo de páginas, controles y adaptadores móviles
Información extensa y detallada sobre el desarrollo de dispositivos móviles en SharePoint Foundation en el nodo llamado Desarrollo de dispositivos móviles con SharePoint Foundation en este SDK.